Delete an option

DELETE/v2/experiences/{experienceId}/options/{optionId}

Requires your API key in the X-API-Key header.

Soft-deletes an option: it disappears from all API reads but its historical bookings keep their snapshots. Only the experience's organizer may delete (403 otherwise); returns 400 on externally-sourced experiences. The deleted option is also pushed to the bottom of the sibling sort order and the experience's minimum price is recomputed asynchronously.

Requestbash
curl -X DELETE "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/options/3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • optionIdstring (uuid)required

    UUID of the option (must belong to the experience in the path).

    Example:
    3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6

Responses

204

Option deleted.

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."
    }
  ]
}