Docs
Get Advance Task Status Mapping
GET /advanceTaskStatusMapping
GET
/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. |
Returns the advance task status mapping for the event, if one exists. This mapping links the advance workflow states (not started, needs review, done, archived) to specific task statuses defined in the event's project management settings.
The mapping is required for the advance task tracking feature to work. If no mapping has been configured, the response body will be null.
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.
Example Response
{
"id": "mapping-guid-001",
"notStartedStatusId": "status-guid-001",
"needsReviewStatusId": "status-guid-002",
"doneStatusId": "status-guid-003",
"archivedStatusId": "status-guid-004"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| id | Guid | The mapping's unique ID. |
| notStartedStatusId | Guid | Task status used when an advance block has not been started. |
| needsReviewStatusId | Guid | Task status used when an advance request's approval changes and the block needs review. |
| doneStatusId | Guid | Task status used when a question or request block is marked as reviewed. |
| archivedStatusId | Guid | Task status used for archived advance module tasks. |
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token. |