Docs
Upsert Advance Task Status Mapping
PUT /advanceTaskStatusMapping
PUT
/advanceTaskStatusMappingRequired 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. |
Creates or updates the advance task status mapping for the event. All four status IDs must reference valid task statuses belonging to this event.
This mapping is required for the advance task tracking feature. Once configured, changes to advance request approvals and review actions will automatically drive task status transitions based on these mappings.
Returns 200 OK with no body on success.
Event scoping: These endpoints do not include {eventId} in the URL. The event is determined automatically from your x-Event-Token — the API uses it to know which event's data to return. Ensure you have a valid event token before making any calls in this folder.
Requires EventProjectManagementAdmin permission on the event.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| notStartedStatusId | Guid | Required | ID of the task status to use for blocks that have not been started. Must belong to this event. |
| needsReviewStatusId | Guid | Required | ID of the task status to use when an approval change triggers a re-review. Must belong to this event. |
| doneStatusId | Guid | Required | ID of the task status to use when a block is marked as reviewed/done. Must belong to this event. |
| archivedStatusId | Guid | Required | ID of the task status to use for archived advance module tasks. Must belong to this event. |
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token, or caller lacks EventProjectManagementAdmin. |
NOT_FOUND | 404 | One or more of the provided status IDs do not exist for this event. |