Delete (deactivate) an experience

DELETE/v2/experiences/{id}

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

Soft-deletes an experience by flagging it inactive; the record is retained (bookings may reference it forever) but disappears from all API reads. Only the owning organizer may delete (403 otherwise). Returns 204 with no body.

Requestbash
curl -X DELETE "https://api.turneo.co/v2/experiences/5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • idstringrequired

    Experience UUID, or the legacy string experienceId of an experience migrated from the old platform — UUIDs are tried first, any non-UUID value is looked up as a legacy ID.

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

Responses

204

Experience deactivated.

Errors

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 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}