> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomarketbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update one of the signed-in supplier’s travel zones

> Change any of the zone’s fields; send the row’s current `version` (optimistic concurrency — a stale one is a 409). A geometry change re-computes the coverage of every schedule that uses the zone; `coverageRecompute` reports how many and how many failed. A rename or other non-geometry edit leaves the schedules alone and the response has no `coverageRecompute`. Requires the API key and the supplier’s user token.



## OpenAPI

````yaml /api-reference/openapi.json patch /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}
openapi: 3.0.0
info:
  title: MarketBox 2.0 Open API
  version: 1.0.0
  description: >-
    The MarketBox public API for building booking experiences. Core model:
    create an order, then draw its order items down into bookings. Single
    bookings reference an order item per service line; package bookings draw one
    PACKAGE item down across N sessions. To schedule a package, build a slate
    (POST /availability/package-slate) and book it by slateId (POST
    /orders/{orderId}/package-bookings). See the guides for end-to-end
    walkthroughs.
  contact:
    name: MarketBox support
servers:
  - url: https://apiv2.gomarketbox.com
    description: MarketBox Open API
security:
  - ApiKeyAuth: []
paths:
  /v1/projects/{projectId}/suppliers/me/travel-zones/{travelZoneId}:
    patch:
      tags:
        - Supplier plane
      summary: Update one of the signed-in supplier’s travel zones
      description: >-
        Change any of the zone’s fields; send the row’s current `version`
        (optimistic concurrency — a stale one is a 409). A geometry change
        re-computes the coverage of every schedule that uses the zone;
        `coverageRecompute` reports how many and how many failed. A rename or
        other non-geometry edit leaves the schedules alone and the response has
        no `coverageRecompute`. Requires the API key and the supplier’s user
        token.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: >-
              The project (tenant) that owns the resource. Every resource in
              this API is scoped to a project, and your API key is restricted to
              the projects it was issued for — a project outside that scope
              returns 403.
            example: prj_01kv60qgnef2kt3pvqgwmkbzfr
          required: true
          description: >-
            The project (tenant) that owns the resource. Every resource in this
            API is scoped to a project, and your API key is restricted to the
            projects it was issued for — a project outside that scope returns
            403.
          name: projectId
          in: path
        - schema:
            type: string
            minLength: 1
            description: >-
              The travel zone — an area the supplier travels to, a circle or a
              drawn polygon.
            example: stz_01kv60qgnef2kt3pvqgwmkbzfr
          required: true
          description: >-
            The travel zone — an area the supplier travels to, a circle or a
            drawn polygon.
          name: travelZoneId
          in: path
      requestBody:
        description: Fields to update
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  description: >-
                    The zone’s display name, as the supplier and staff see it.
                    Omit to leave it unchanged.
                  example: Downtown Toronto
                defaultLanguage:
                  type: string
                  minLength: 1
                  description: >-
                    The language `name` is written in (BCP 47). Omit to leave it
                    unchanged.
                  example: en
                nameI18n:
                  type: object
                  additionalProperties:
                    type: string
                    minLength: 1
                  description: >-
                    The name in other languages, keyed by BCP 47 language tag.
                    Omit to leave it unchanged.
                  example:
                    fr: Centre-ville de Toronto
                addressOneLine:
                  type: string
                  nullable: true
                  description: >-
                    The address of the zone’s centre, on one line. Omit to leave
                    it unchanged; pass null to clear it.
                  example: 100 Queen St W, Toronto, ON M5H 2N2
                street:
                  type: string
                  nullable: true
                  description: >-
                    Street address of the zone’s centre. Omit to leave it
                    unchanged; pass null to clear it.
                  example: 100 Queen St W
                city:
                  type: string
                  nullable: true
                  description: >-
                    City of the zone’s centre. Omit to leave it unchanged; pass
                    null to clear it.
                  example: Toronto
                state:
                  type: string
                  nullable: true
                  description: >-
                    State or province of the zone’s centre. Omit to leave it
                    unchanged; pass null to clear it.
                  example: 'ON'
                country:
                  type: string
                  nullable: true
                  description: >-
                    Country of the zone’s centre. Omit to leave it unchanged;
                    pass null to clear it.
                  example: CA
                postalCode:
                  type: string
                  nullable: true
                  description: >-
                    Postal or ZIP code of the zone’s centre. Omit to leave it
                    unchanged; pass null to clear it.
                  example: M5H 2N2
                longitude:
                  type: number
                  description: >-
                    Longitude of the zone’s centre (for a CIRCULAR zone, the
                    centre of the circle). Omit to leave it unchanged.
                  example: -79.3832
                latitude:
                  type: number
                  description: >-
                    Latitude of the zone’s centre (for a CIRCULAR zone, the
                    centre of the circle). Omit to leave it unchanged.
                  example: 43.6532
                timezone:
                  type: string
                  nullable: true
                  minLength: 1
                  description: >-
                    IANA time zone of the zone’s area. Omit to leave it
                    unchanged; pass null to clear it.
                  example: America/Toronto
                travelZoneType:
                  type: string
                  enum:
                    - CIRCULAR
                    - DRAWN
                  description: >-
                    CIRCULAR = a radius around the centre (travelDistance and
                    travelDistanceUnit); DRAWN = the polygons in travelRegions.
                    Omit to keep the zone’s type; switching it requires the new
                    type’s geometry fields.
                  example: CIRCULAR
                travelDistance:
                  type: number
                  nullable: true
                  minimum: 0
                  exclusiveMinimum: true
                  description: >-
                    The radius of a CIRCULAR zone, in travelDistanceUnit.
                    Required for CIRCULAR, null for DRAWN. Omit to leave it
                    unchanged.
                  example: 15
                travelDistanceUnit:
                  type: string
                  nullable: true
                  enum:
                    - KM
                    - MILES
                    - null
                  description: >-
                    The unit of travelDistance. Required for CIRCULAR, null for
                    DRAWN. Omit to leave it unchanged.
                  example: KM
                travelRegions:
                  type: object
                  nullable: true
                  properties:
                    type:
                      type: string
                      enum:
                        - Polygon
                        - MultiPolygon
                      description: The GeoJSON geometry type.
                      example: Polygon
                    coordinates:
                      nullable: true
                      description: >-
                        The GeoJSON coordinates: rings of [longitude, latitude]
                        positions, each ring closed (its last position equals
                        its first).
                      example:
                        - - - -79.42
                            - 43.63
                          - - -79.33
                            - 43.63
                          - - -79.33
                            - 43.69
                          - - -79.42
                            - 43.69
                          - - -79.42
                            - 43.63
                  required:
                    - type
                  description: >-
                    The area of a DRAWN zone, a GeoJSON Polygon or MultiPolygon.
                    Required for DRAWN, null for CIRCULAR. Omit to leave it
                    unchanged.
                  example:
                    type: Polygon
                    coordinates:
                      - - - -79.42
                          - 43.63
                        - - -79.33
                          - 43.63
                        - - -79.33
                          - 43.69
                        - - -79.42
                          - 43.69
                        - - -79.42
                          - 43.63
                active:
                  type: boolean
                  description: >-
                    Active zones can be used by schedules; an inactive zone is
                    kept but offers nothing. Omit to leave it unchanged.
                  example: true
                version:
                  type: integer
                  minimum: 0
                  exclusiveMinimum: true
                  description: >-
                    The row’s current version, for optimistic concurrency; a
                    stale value is a 409. Send the version you read.
                  example: 1
              required:
                - version
      responses:
        '200':
          description: Travel zone updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      supplierTravelZoneId:
                        type: string
                        description: The travel zone’s id.
                        example: stz_01kv60qgnef2kt3pvqgwmkbzfr
                      projectId:
                        type: string
                        description: The project the zone belongs to.
                        example: prj_01kv60qge5eh59ap0gw0pqrrys
                      supplierId:
                        type: string
                        description: >-
                          The supplier whose zone this is — always the supplier
                          it was created for.
                        example: sup_01kv60qgnef2kt3pvqgwmkbzfr
                      name:
                        type: string
                        description: >-
                          The zone’s display name, as the supplier and staff see
                          it.
                        example: Downtown Toronto
                      nameNormalized:
                        type: string
                        description: >-
                          The name trimmed, lower-cased and with runs of spaces
                          collapsed; what `namePrefix` matches.
                        example: downtown toronto
                      defaultLanguage:
                        type: string
                        description: The language `name` is written in (BCP 47).
                        example: en
                      nameI18n:
                        type: object
                        additionalProperties:
                          type: string
                        description: >-
                          The name in other languages, keyed by BCP 47 language
                          tag.
                        example:
                          fr: Centre-ville de Toronto
                      addressOneLine:
                        type: string
                        nullable: true
                        description: The address of the zone’s centre, on one line.
                        example: 100 Queen St W, Toronto, ON M5H 2N2
                      street:
                        type: string
                        nullable: true
                        description: Street address of the zone’s centre.
                        example: 100 Queen St W
                      city:
                        type: string
                        nullable: true
                        description: City of the zone’s centre.
                        example: Toronto
                      state:
                        type: string
                        nullable: true
                        description: State or province of the zone’s centre.
                        example: 'ON'
                      country:
                        type: string
                        nullable: true
                        description: Country of the zone’s centre.
                        example: CA
                      postalCode:
                        type: string
                        nullable: true
                        description: Postal or ZIP code of the zone’s centre.
                        example: M5H 2N2
                      longitude:
                        type: number
                        description: >-
                          Longitude of the zone’s centre (for a CIRCULAR zone,
                          the centre of the circle).
                        example: -79.3832
                      latitude:
                        type: number
                        description: >-
                          Latitude of the zone’s centre (for a CIRCULAR zone,
                          the centre of the circle).
                        example: 43.6532
                      timezone:
                        type: string
                        nullable: true
                        description: IANA time zone of the zone’s area.
                        example: America/Toronto
                      travelZoneType:
                        type: string
                        enum:
                          - CIRCULAR
                          - DRAWN
                        description: >-
                          CIRCULAR = a radius around the centre (travelDistance
                          and travelDistanceUnit); DRAWN = the polygons in
                          travelRegions.
                        example: CIRCULAR
                      travelDistance:
                        type: number
                        nullable: true
                        description: >-
                          The radius of a CIRCULAR zone, in travelDistanceUnit.
                          Required for CIRCULAR, null for DRAWN.
                        example: 10
                      travelDistanceUnit:
                        type: string
                        nullable: true
                        enum:
                          - KM
                          - MILES
                          - null
                        description: >-
                          The unit of travelDistance. Required for CIRCULAR,
                          null for DRAWN.
                        example: KM
                      travelRegions:
                        type: object
                        nullable: true
                        properties:
                          type:
                            type: string
                            enum:
                              - Polygon
                              - MultiPolygon
                            description: The GeoJSON geometry type.
                            example: Polygon
                          coordinates:
                            nullable: true
                            description: >-
                              The GeoJSON coordinates: rings of [longitude,
                              latitude] positions, each ring closed (its last
                              position equals its first).
                            example:
                              - - - -79.42
                                  - 43.63
                                - - -79.33
                                  - 43.63
                                - - -79.33
                                  - 43.69
                                - - -79.42
                                  - 43.69
                                - - -79.42
                                  - 43.63
                        required:
                          - type
                        description: >-
                          The area of a DRAWN zone, a GeoJSON Polygon or
                          MultiPolygon. Required for DRAWN, null for CIRCULAR.
                        example: null
                      active:
                        type: boolean
                        description: >-
                          Active zones can be used by schedules; an inactive
                          zone is kept but offers nothing.
                        example: true
                      deleted:
                        type: boolean
                        description: True once the zone is soft-deleted.
                        example: false
                      version:
                        type: integer
                        minimum: 0
                        exclusiveMinimum: true
                        description: >-
                          The row’s current version, for optimistic concurrency;
                          a stale value is a 409.
                        example: 1
                      createdAt:
                        type: string
                        description: When the zone was created (ISO 8601, UTC).
                        example: '2026-10-01T14:00:00.000Z'
                      updatedAt:
                        type: string
                        description: When the zone was last changed (ISO 8601, UTC).
                        example: '2026-10-01T14:00:00.000Z'
                    required:
                      - supplierTravelZoneId
                      - projectId
                      - supplierId
                      - name
                      - nameNormalized
                      - longitude
                      - latitude
                      - travelZoneType
                      - active
                      - deleted
                      - version
                      - createdAt
                      - updatedAt
                  coverageRecompute:
                    type: object
                    properties:
                      total:
                        type: integer
                        minimum: 0
                        description: How many schedules use the zone and were re-computed.
                        example: 3
                      failed:
                        type: integer
                        minimum: 0
                        description: >-
                          How many of them could not be re-computed; those keep
                          their previous coverage until they are next saved.
                        example: 0
                    required:
                      - total
                      - failed
                    description: Present only when the change moved the zone’s geometry.
                required:
                  - data
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '401':
          description: Missing or invalid API key or user token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '403':
          description: >-
            The API key cannot access this project (FORBIDDEN) or lacks standard
            API access (CAPABILITY_NOT_GRANTED); or the signed-in user has no
            MarketBox account record (FORBIDDEN, "User account not found.
            Complete registration first."); or the signed-in user is not a
            member of the project (NOT_A_MEMBER), their membership has ended
            (MEMBERSHIP_INACTIVE), or the roles they act under lack the route’s
            permission (NO_SUPPLIER_ROLE); or X-MB-Acting-Role names a role they
            do not hold (ACTING_ROLE_NOT_HELD)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '404':
          description: >-
            The signed-in user has no supplier record here: no SUPPLIER among
            the roles they act under (NO_SUPPLIER_ROLE), or no single supplier
            record linked to them (SUPPLIER_NOT_LINKED); or no such travel zone
            of theirs (NOT_FOUND)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '409':
          description: 'VERSION_CONFLICT: the row changed since you read it'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
      security:
        - ApiKeyAuth: []
          EndUserBearer: []
components:
  schemas:
    ErrorMessage:
      type: object
      properties:
        code:
          type: string
          description: Stable machine-readable error code, e.g. NOT_FOUND.
        message:
          type: string
          description: Human-readable description of what went wrong.
        statusCode:
          type: integer
          description: The HTTP status code of this response.
        requestId:
          type: string
          description: >-
            The id of this request, also returned as the X-Request-Id header.
            Quote it in a support ticket.
      required:
        - code
        - message
        - statusCode
        - requestId
      example:
        code: NOT_FOUND
        message: Booking not found
        statusCode: 404
        requestId: a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key minted in the MarketBox dashboard. Scope is restricted to the
        projects you select at creation time. Every route needs the key's
        standard API access (`*`) except `POST /v1/projects/{projectId}/events`,
        which needs `events:write`; a key without `*` is refused with 403
        `CAPABILITY_NOT_GRANTED`.
    EndUserBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        The signed-in person's Cognito access token, issued to this
        application's app client. Sent with the API key on the /clients/me and
        /suppliers/me routes.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.