Reorder an experience's options
POST/v2/experiences/{id}/reorder-options
Requires your API key in the X-API-Key header.
Sets the display order of all of an experience's options in one call. The submitted list must contain every visible option exactly once — partial lists, duplicates, unknown IDs and empty lists are all rejected with 400. Options of experiences with an external availability source (Bokun/Regiondo) cannot be reordered (400).
Only the owning organizer can reorder (403 otherwise). The new order is immediately
reflected by GET /v2/experiences/{id}/options and the embedded options list,
and can alternatively be set inline via PATCH /v2/experiences/{id} with
orderedOptionIds.
curl -X POST "https://api.turneo.co/v2/experiences/5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b/reorder-options" \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"orderedOptionIds": [
"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
"1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
]
}'Path parameters
idstringrequiredExperience UUID (or legacy experience ID).
- Example:
5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b
Request bodyapplication/json, required
orderedOptionIdsstring (uuid)[]requiredEvery visible option ID of the experience, exactly once, in the desired display order. Partial lists, duplicates, unknown IDs and empty lists are rejected with 400.
Example: reorder
{
"orderedOptionIds": [
"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
"1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
]
}Responses
200object
Order applied.
okbooleanAlways
trueon success.- Example:
true
{
"ok": true
}Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}