Schedule
Update timeslot

3min
Update an existing timeslot in an event
PUT
Params
Path Params
{organizationId}
required
Number
The id of the Brella organization you are trying to retrieve data from
{eventId}
required
Number
The id of the Brella event you are trying to retrieve data from
Header Parameters
Brella-API-Access-Token
required
String
Your unique Brella API key
Accept
required
String
application/vnd.brella.v4+json
Content-Type
required
String
application/json
Curl
curl --location -g --request PUT 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/timeslots/bulk_update' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: application/vnd.brella.v4+json' \
--header 'Content-Type: application/json'\
--data '{  
     "timeslots": [{      
           "title": "{{session_title}}",      
           "start_time": "{{2029-06-10T14:30:00+0200T}}",      
           "end_time": "{{2029-11-10T16:00:00+0200}}",      
           "content": "{{You can write <p>html</p> or just have a string. Anything here will be converted to DraftJs-consumable object}}",  
           "track":"{{trackName}}",     
           "location": "{{Main hall and Venue}}",
           "tags": ["tag 01", "tag 02", "tag 03", "tag 04", "tag 05"],
           "external_id": "{{SomeExternalId}}"    
}]
}'













'
curl --location -g --request PUT 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/timeslots/bulk_update' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: application/vnd.brella.v4+json' \
--header 'Content-Type: application/json'\
--data '{  
     "timeslots": [{      
           "title": "{{session_title}}",      
           "start_time": "{{2029-06-10T14:30:00+0200T}}",      
           "end_time": "{{2029-11-10T16:00:00+0200}}",      
           "content": "{{You can write <p>html</p> or just have a string. Anything here will be converted to DraftJs-consumable object}}",  
           "track":"{{trackName}}",     
           "location": "{{Main hall and Venue}}",
           "tags": ["tag 01", "tag 02", "tag 03", "tag 04", "tag 05"],
           "external_id": "{{SomeExternalId}}"    
}]
}'













'
Responses
200
{
  "data": [
    {
      "id": "107877",
      "type": "timeslot",
      "attributes": {
        "title": "Updated title of your session",
        "reservable": "false",
        "duration": "90",
        "location": "Main hall and Venue",
        "content": {
          "blocks": [
            {
              "text": "You can write ",
              "type": "unstyled",
              "depth": "0",
              "entity-ranges": [],
              "inline-style-ranges": []
            },
            {
              "text": "html",
              "type": "unstyled",
              "depth": "0",
              "entity-ranges": [],
              "inline-style-ranges": []
            },
            {
              "text": " or just have a string. Anything here will be converted to DraftJs-consumable object",
              "type": "unstyled",
              "depth": "0",
              "entity-ranges": [],
              "inline-style-ranges": []
            }
          ],
          "entity-map": {}
        },
        "subtitle": "",
        "highlight-position": {},
        "stream-link": {},
        "chat-channel-id": "timeslot-107877",
        "start-time": "2025-11-27T00:30:00.000Z",
        "end-time": "2025-11-27T02:00:00.000Z",
        "tag-order": [
          "74339",
          "74340",
          "74341",
          "74342",
          "74583"
        ]
      },
      "relationships": {
        "tags": {
          "data": [
            {
              "id": "74339",
              "type": "tag"
            },
            {
              "id": "74340",
              "type": "tag"
            },
            {
              "id": "74341",
              "type": "tag"
            },
            {
              "id": "74342",
              "type": "tag"
            },
            {
              "id": "74583",
              "type": "tag"
            }
          ]
        },
        "locations": {
          "data": [
            {
              "id": "74343",
              "type": "tag"
            }
          ]
        },
        "speaker-assignments": {
          "data": []
        },
        "speakers": {
          "data": []
        },
        "tabs": {
          "data": []
        },
        "attendee-groups": {
          "data": []
        },
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        },
        "track": {
           "data": {
            "id": "49128",
            "type": "track"
                    }
                }
      }
    }
  ],
  "included": [
          {
            "id": "49128",
            "type": "track",
            "attributes": {
                "name": "Track X",
                "description": null,
                "position": 3,
                "enabled": true,
                "default": false,
                "togglable": true,
                "color": "#0080C0",
                "show-highlighted-speakers": false,
                "track-type": "ContentTrack"
            }
        },
    {
      "id": "74339",
      "type": "tag",
      "attributes": {
        "name": "Track 1",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.026Z",
        "created-at": "2023-03-24T10:06:02.026Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74340",
      "type": "tag",
      "attributes": {
        "name": "Keynote 1",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.038Z",
        "created-at": "2023-03-24T10:06:02.038Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74341",
      "type": "tag",
      "attributes": {
        "name": "UX",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.048Z",
        "created-at": "2023-03-24T10:06:02.048Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74342",
      "type": "tag",
      "attributes": {
        "name": "AI",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.057Z",
        "created-at": "2023-03-24T10:06:02.057Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74583",
      "type": "tag",
      "attributes": {
        "name": "A test tag",
        "color": "#58D78E",
        "updated-at": "2023-03-27T08:45:11.105Z",
        "created-at": "2023-03-27T08:45:11.105Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74343",
      "type": "tag",
      "attributes": {
        "name": "Main hall and Venue",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.065Z",
        "created-at": "2023-03-24T10:06:02.065Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    }
  ],
  "meta": {
    "failures": []
  }
}
{
  "data": [
    {
      "id": "107877",
      "type": "timeslot",
      "attributes": {
        "title": "Updated title of your session",
        "reservable": "false",
        "duration": "90",
        "location": "Main hall and Venue",
        "content": {
          "blocks": [
            {
              "text": "You can write ",
              "type": "unstyled",
              "depth": "0",
              "entity-ranges": [],
              "inline-style-ranges": []
            },
            {
              "text": "html",
              "type": "unstyled",
              "depth": "0",
              "entity-ranges": [],
              "inline-style-ranges": []
            },
            {
              "text": " or just have a string. Anything here will be converted to DraftJs-consumable object",
              "type": "unstyled",
              "depth": "0",
              "entity-ranges": [],
              "inline-style-ranges": []
            }
          ],
          "entity-map": {}
        },
        "subtitle": "",
        "highlight-position": {},
        "stream-link": {},
        "chat-channel-id": "timeslot-107877",
        "start-time": "2025-11-27T00:30:00.000Z",
        "end-time": "2025-11-27T02:00:00.000Z",
        "tag-order": [
          "74339",
          "74340",
          "74341",
          "74342",
          "74583"
        ]
      },
      "relationships": {
        "tags": {
          "data": [
            {
              "id": "74339",
              "type": "tag"
            },
            {
              "id": "74340",
              "type": "tag"
            },
            {
              "id": "74341",
              "type": "tag"
            },
            {
              "id": "74342",
              "type": "tag"
            },
            {
              "id": "74583",
              "type": "tag"
            }
          ]
        },
        "locations": {
          "data": [
            {
              "id": "74343",
              "type": "tag"
            }
          ]
        },
        "speaker-assignments": {
          "data": []
        },
        "speakers": {
          "data": []
        },
        "tabs": {
          "data": []
        },
        "attendee-groups": {
          "data": []
        },
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        },
        "track": {
           "data": {
            "id": "49128",
            "type": "track"
                    }
                }
      }
    }
  ],
  "included": [
          {
            "id": "49128",
            "type": "track",
            "attributes": {
                "name": "Track X",
                "description": null,
                "position": 3,
                "enabled": true,
                "default": false,
                "togglable": true,
                "color": "#0080C0",
                "show-highlighted-speakers": false,
                "track-type": "ContentTrack"
            }
        },
    {
      "id": "74339",
      "type": "tag",
      "attributes": {
        "name": "Track 1",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.026Z",
        "created-at": "2023-03-24T10:06:02.026Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74340",
      "type": "tag",
      "attributes": {
        "name": "Keynote 1",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.038Z",
        "created-at": "2023-03-24T10:06:02.038Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74341",
      "type": "tag",
      "attributes": {
        "name": "UX",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.048Z",
        "created-at": "2023-03-24T10:06:02.048Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74342",
      "type": "tag",
      "attributes": {
        "name": "AI",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.057Z",
        "created-at": "2023-03-24T10:06:02.057Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74583",
      "type": "tag",
      "attributes": {
        "name": "A test tag",
        "color": "#58D78E",
        "updated-at": "2023-03-27T08:45:11.105Z",
        "created-at": "2023-03-27T08:45:11.105Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    },
    {
      "id": "74343",
      "type": "tag",
      "attributes": {
        "name": "Main hall and Venue",
        "color": "#58D78E",
        "updated-at": "2023-03-24T10:06:02.065Z",
        "created-at": "2023-03-24T10:06:02.065Z"
      },
      "relationships": {
        "event": {
          "data": {
            "id": "197444",
            "type": "event"
          }
        }
      }
    }
  ],
  "meta": {
    "failures": []
  }
}
﻿
REQUEST BODY
{  
   "timeslots": [{      
     "title": "{{session_title}}",      
     "start_time": "{{2029-06-10T14:30:00+0200T}}",      
     "end_time": "{{2029-11-10T16:00:00+0200}}",      
     "content": "{{You can write <p>html</p> or just have a string. Anything here will be converted to DraftJs-consumable object}}",   
     "track":"{{trackName}}",    
     "location": "{{Main hall and Venue}}",
     "tags": ["tag 01", "tag 02", "tag 03", "tag 04", "tag 05"],
     "external_id": "D00BYD11-01"    
}]
}
Required attributes:
title String / the title of the session happening in this timeslot
start_time DateTime / the start date and time; see notes for more information on formatting
end_time DateTime / the start date and time; see notes for more information on formatting
external_id String / see notes for more information
tags List / if not used, an empty list [] must be sent
Notes:
01: start_time and end_time must be specified in the following format:
YYYY-MM-DDTHH:mm:ssZ
eg: 2029-06-10T14:30:00+0200
The timezone of the event must be specified accurately, as the API will pass data in UTC time. In the example above +0200 refers to Helsinki time.
Make sure that the date and time are within the event dates specified in Brella (if your event dates aren't correctly set-up in Brella, first do so via the Admin Panel (Event > Details).
You may need to do some formatting within your integration before passing this data to Brella
02: track is not technically required, but is highly recommended when passing timeslots via the API — especially if multiple sessions take place simultaneously. A single track cannot have overlapping sessions — the endpoint will return an error if this is the case. 
If the track attribute is empty / not passed, Brella will automatically re-assign the timeslot being updated by the request to the default track. 
The tracks can be existing schedule tracks (created in the Admin Panel), or tracks that do not exist. If the value passed in the track attribute doesn't match an existing track's name, Brella will create a new track named with the value of the track attribute in the request and assign the timeslot there. 
03: external_id is not technically required, but is highly recommended when passing timeslots via the API. This value is used to update timeslots, and to find specific timeslots via the API. Typically, it would contain a shared value between the 3rd party system the data is coming from and Brella (eg: you could pass the unique identifier generated by the 3rd party system to the external_id attribute in Brella.. 
Updated 13 Jul 2023
Did this page help you?
Create timeslot
Delete timeslot
Docs powered by Archbee
TABLE OF CONTENTS
PUT
Update existing timeslot