Delete a participant type

DELETE/v2/experiences/{experienceId}/participant-types/{participantTypeId}

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

Soft-deletes a custom participant type. Only the experience's organizer may delete. Default types (Adult, Child, Infant) can never be deleted (403). The type must first be disabled on every active option of the experience — if any active option still enables it, the delete is rejected with a 400. On success the type and its per-variant prices are deactivated together and the experience's minimum price is recomputed asynchronously.

Requestbash
curl -X DELETE "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/participant-types/a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

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

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

    Example:
    a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44

Responses

204

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