Skip to content
Docs
Open Backstage
Operation

Apply layout changes

POST/events/{eventId}/layout/apply
Starts the workflow that applies a set of layout changes to an event and its occurrences, and answers with the workflow id to follow.

Path parameters

eventIdstringRequired
Event ID

Headers

Idempotency-KeystringOptional
Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

Errors

400
Bad Request - Invalid input
401
Unauthorized - Authentication required
403
Forbidden - Insufficient permissions
404
Not Found - Resource not found
500
Internal Server Error

Every error names its code and links to it. All error codes

curl -X POST "https://api.ticketlayer.com/v1/events/evt_abc123/layout/apply" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug" \  -H "Content-Type: application/json" \  -d '{    "accountId": "acc_abc123",    "changes": {      "removedSeats": [        "eas_seat1",        "eas_seat2"      ],      "addedSeats": [        {          "id": "string",          "areaId": "string",          "row": "string",          "number": "string",          "priceCategory": "string",          "isAccessible": true,          "isCompanion": true        }      ],      "capacityChanges": [        {          "areaId": "string",          "oldCapacity": 0,          "newCapacity": 0        }      ],      "seatAttributeChanges": [        {          "seatId": "string",          "changes": {            "priceCategory": "string",            "isAccessible": true,            "isCompanion": true          }        }      ]    },    "futureOnly": true  }'
Response 202
{
  "workflowId": "layout-apply-evt_abc123-1712345678901",
  "message": "Layout change workflow started"
}

Try it in test mode

Path parameters
Event ID