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.

Requestbash
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

  • idstringrequired

    Experience UUID (or legacy experience ID).

    Example:
    5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b

Request bodyapplication/json, required

  • orderedOptionIdsstring (uuid)[]required

    Every 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
reorderjson
{
  "orderedOptionIds": [
    "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
  ]
}

Responses

200object

Order applied.

  • okboolean

    Always true on success.

    Example:
    true
Response 200json
{
  "ok": true
}

Errors

400

Validation failed. Inspect errors[].field and errors[].code.

401

Missing or invalid X-API-Key header.

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
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}