Tracks

Create and update tracks with complete curl request examples.

Collection path: events/{event_id}/tracks

Input	Type	POST	PATCH	Notes
`name`	Scalar string	Required by the model	Optional	Event-unique track name.
`description`	Scalar string or `null`	Optional	Optional	Description.
`color`	Scalar string or `null`	Optional	Optional	Color.
`enabled`	JSON boolean	Optional	Optional	Enabled setting.
`show_highlighted_speakers`	JSON boolean	Optional	Optional	Highlight display setting.
`default_session_cover_image`	Scalar string	Optional	Optional	Base64 data URI. Blank on PATCH removes the image.
`sponsor_ids`	Array of scalar IDs	Optional	Optional	Full replacement; every sponsor must belong to the event.
`highlighted_speaker_ids`	Array of scalar IDs	Optional	Optional	Full replacement; every speaker must belong to the event.

type, default, togglable, and position are response fields but are not writable through the Core track wrapper. POST always creates a ContentTrack.

POST a track

curl --request POST \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/tracks" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "name": "Main stage",
    "description": "Keynotes and panels",
    "color": "#123456",
    "enabled": true,
    "show_highlighted_speakers": true,
    "sponsor_ids": [103705],
    "highlighted_speaker_ids": [801, 802]
  }'

The response type is track. Useful write-response fields include name, description, color, enabled, type (returned as track-type), sponsor_ids, highlighted_speaker_ids, and updated_at.

PATCH a track

curl --request PATCH \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/tracks/501" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "name": "Main stage and keynotes",
    "color": "#234567",
    "sponsor_ids": [103705, 103706],
    "highlighted_speaker_ids": [801]
  }'

An empty sponsor_ids or highlighted_speaker_ids array removes all records from that association. Default tracks cannot be deleted, but that restriction does not affect PATCH.