Partially update a participant type

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

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

Partial update of a participant type. Same rules as PUT: organizer-only, and default types accept changes to minAge/maxAge only.

Requestbash
curl -X PATCH "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>" \
  -H "Content-Type: application/json" \
  -d '{
    "minAge": 4,
    "maxAge": 15
  }'

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

Request bodyapplication/json, required

  • namemap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • descriptionmap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • minAgeintegernullable

    Minimum age (inclusive).

    Example:
    65
  • maxAgeintegernullable

    Maximum age (inclusive).

  • capacityExemptboolean

    Exclude this type from capacity counting.

    Example:
    false
  • sortOrderinteger

    Display position (ascending).

    Example:
    4
  • isDefaultboolean

    Whether this is a seeded default type. Custom types created through the API should leave this false; non-default types start disabled on every existing option.

    Example:
    false
  • externalIdstringnullable

    External provider identifier (used by provider sync).

Example: Tune the Child age range on a default type
Tune the Child age range on a default typejson
{
  "minAge": 4,
  "maxAge": 15
}

Responses

200object

Updated participant type.

  • idstring (uuid)

    Participant type id.

    Example:
    a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44
  • experienceIdstring (uuid)read-only

    The parent experience id.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • namemap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • descriptionmap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • minAgeintegernullable

    Minimum age (inclusive), or null when unbounded.

    Example:
    18
  • maxAgeintegernullable

    Maximum age (inclusive), or null when unbounded.

  • capacityExemptboolean

    When true, participants of this type (e.g. infants) do not count toward slot or variant capacity.

    Example:
    false
  • sortOrderinteger

    Display position (ascending).

    Example:
    0
  • isDefaultboolean

    True for the seeded Adult/Child/Infant types. Default types cannot be deleted and only their age range can be edited.

    Example:
    true
  • externalIdstringnullable

    External provider identifier when synced from Bokun/Regiondo/Kompas.

  • isEnabledOnBookableOptionsbooleanread-only

    Computed: true when at least one ACTIVE, non-custom option of the experience enables this type AND has a future bookable availability slot — i.e. a guest could actually book it right now.

    Example:
    true
Response 200json
{
  "id": "a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44",
  "experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
  "name": {
    "en": "Shared boat tour",
    "de": "Gemeinsame Bootstour"
  },
  "description": {
    "en": "Shared boat tour",
    "de": "Gemeinsame Bootstour"
  },
  "minAge": 18,
  "maxAge": null,
  "capacityExempt": false,
  "sortOrder": 0,
  "isDefault": true,
  "externalId": null,
  "isEnabledOnBookableOptions": 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."
    }
  ]
}