Docs
Update Activity Segment
PUT /Activities/{activityId}/segments/{segmentId}
PUT
/Activities/{activityId}/segments/{segmentId}Required Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Replaces all fields of an existing segment. This is a full update — all fields must be provided.
Requires EventAdmin permission on the event.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| activityId | Guid | Required | The ID of the activity. |
| segmentId | Guid | Required | The ID of the segment to update. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| index | int | Required | Zero-based position in the run of show. Changing this reorders other segments automatically. |
| name | string | Required | Display name for the segment. |
| duration | int | Required | Duration of the segment in minutes. |
| color | string | Required | Display color for the segment. |
| properties | array | Optional | Values for the activity's configuration columns. See property object below. |
Property Object
| Field | Type | Required | Description |
|---|---|---|---|
| columnId | Guid | Required | The ID of the configuration column this value belongs to. |
| value | string | Required | The value for this column on this segment. |
Response
Returns 200 OK with no body on success.