openapi: 3.0.4
info:
  title: Mews Booking Engine API (Distributor) Account notes Resources API
  version: v1
  description: The Mews Booking Engine API (historically the Distributor API, served from /api/distributor/v1) lets developers build guest-facing booking engines that create reservations directly in Mews. It exposes enterprise configuration, availability, pricing, products, vouchers, payment cards, and reservation group creation for front-end client consumption.
  x-generated-from: documentation
  x-source-url: https://api.mews.com/Swagger/distributor/swagger.json
  x-last-validated: '2026-06-02'
servers:
- url: https://api.mews.com
  description: Production
- url: https://api.mews-demo.com
  description: Demo / sandbox
security:
- MewsClientToken: []
  MewsAccessToken: []
tags:
- name: Resources
paths:
  /api/connector/v1/resources/getAll:
    post:
      tags:
      - Resources
      summary: Mews Get All Resources
      description: 'Returns all resources of an enterprise associated with the connector integration. Note that when any of the extents is set to `true`, the response contains the entities that are associated to a resource. If the extent is not associated to a resource (e.g. resource category not assigned to any resource), this information is not returned.

        Note this operation uses [Pagination](https://mews-systems.gitbook.io/connector-api/guidelines/pagination/) and supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property).'
      operationId: resources_getAll
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceFilterParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              ResourceIds:
              - 20e00c32-d561-4008-8609-82d8aa525714
              - 1ec29188-01ca-4294-9983-fac59f85a448
              - a1b2c3d4-e5f6-7890-abcd-ef1234567890
              Names:
              - '101'
              - '102'
              - Suite 1
              Extent:
                Resources: true
                ResourceCategories: false
                ResourceCategoryAssignments: false
                ResourceCategoryImageAssignments: false
                ResourceFeatures: false
                ResourceFeatureAssignments: false
                Inactive: false
              CreatedUtc:
                StartUtc: '2023-01-01T00:00:00Z'
                EndUtc: '2023-12-31T23:59:59Z'
              UpdatedUtc:
                StartUtc: '2023-06-01T00:00:00Z'
                EndUtc: '2023-06-30T23:59:59Z'
              EnterpriseIds:
              - 3fa85f64-5717-4562-b3fc-2c963f66afa6
              - 4d0201db-36f5-428b-8d11-4f0a65e960cc
              Limitation:
                Count: 100
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceResult'
              example:
                Resources:
                - Id: 20e00c32-d561-4008-8609-82d8aa525714
                  EnterpriseId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  IsActive: true
                  ParentResourceId: null
                  Name: '101'
                  State: Clean
                  Descriptions:
                    en-US: Standard room with city view
                  CreatedUtc: '2023-01-15T10:30:00Z'
                  UpdatedUtc: '2023-06-15T14:20:00Z'
                  Data:
                    Discriminator: Space
                    Value:
                      FloorNumber: '1'
                      LocationNotes: Building A, near elevator
                  ExternalNames:
                    en-US: Room 101
                  Directions:
                    en-US: Take elevator to first floor, turn right
                - Id: 1ec29188-01ca-4294-9983-fac59f85a448
                  EnterpriseId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  IsActive: true
                  ParentResourceId: 20e00c32-d561-4008-8609-82d8aa525714
                  Name: 101A
                  State: Inspected
                  Descriptions:
                    en-US: Bed in room 101
                  CreatedUtc: '2023-01-15T10:35:00Z'
                  UpdatedUtc: '2023-06-15T14:25:00Z'
                  Data:
                    Discriminator: Object
                    Value: {}
                  ExternalNames:
                    en-US: Bed A
                  Directions:
                    en-US: Located in room 101
                - Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  EnterpriseId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  IsActive: true
                  ParentResourceId: null
                  Name: Suite 1
                  State: Dirty
                  Descriptions:
                    en-US: Luxury suite with ocean view
                  CreatedUtc: '2023-02-01T09:00:00Z'
                  UpdatedUtc: '2023-06-20T16:45:00Z'
                  Data:
                    Discriminator: Space
                    Value:
                      FloorNumber: '5'
                      LocationNotes: Penthouse level, private elevator access
                  ExternalNames:
                    en-US: Presidential Suite
                  Directions:
                    en-US: Private elevator to penthouse level
                ResourceCategories: null
                ResourceCategoryAssignments: null
                ResourceCategoryImageAssignments: null
                ResourceFeatures: null
                ResourceFeatureAssignments: null
                Cursor: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll400Example:
                  summary: Default resources_getAll 400 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll401Example:
                  summary: Default resources_getAll 401 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll403Example:
                  summary: Default resources_getAll 403 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll408Example:
                  summary: Default resources_getAll 408 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll204Example:
                  summary: Default resources_getAll 204 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll429Example:
                  summary: Default resources_getAll 429 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetAll500Example:
                  summary: Default resources_getAll 500 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/connector/v1/resources/update:
    post:
      tags:
      - Resources
      summary: Mews Update Resources
      description: Updates details of the resources.
      operationId: resources_update
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MultipleResourceUpdateParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              ResourceUpdates:
              - ResourceId: 20e00c32-d561-4008-8609-82d8aa525714
                Name:
                  Value: 101 Updated
                Data:
                  Discriminator: Space
                  Value:
                    FloorNumber:
                      Value: '2'
                    LocationNotes:
                      Value: Updated location notes
                State:
                  Value: Inspected
                StateReason:
                  Value: Room inspection completed
              - ResourceId: 1ec29188-01ca-4294-9983-fac59f85a448
                Name:
                  Value: '102'
                ParentResourceId:
                  Value: 20e00c32-d561-4008-8609-82d8aa525714
                State:
                  Value: Clean
              - ResourceId: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                State:
                  Value: OutOfService
                StateReason:
                  Value: Maintenance required
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unit'
              example: {}
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate400Example:
                  summary: Default resources_update 400 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate401Example:
                  summary: Default resources_update 401 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate403Example:
                  summary: Default resources_update 403 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate408Example:
                  summary: Default resources_update 408 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate204Example:
                  summary: Default resources_update 204 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate429Example:
                  summary: Default resources_update 429 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesUpdate500Example:
                  summary: Default resources_update 500 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/connector/v1/resources/getOccupancyState:
    post:
      tags:
      - Resources
      summary: Mews Get Resources' Occupancy State
      description: Returns the occupancy state of the specified resources. This operation returns the occupancy state for the current day. Note this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property/).
      operationId: resources_getOccupancyState
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourcesOccupancyStateFilterParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              ResourceCategoryIds:
              - 773d5e42-de1e-43a0-9ce6-f940faf2303f
              ResourceStates:
              - Clean
              - Inspected
              OccupancyStates:
              - Vacant
              - Reserved
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourcesOccupancyStateResult'
              example:
                ResourceCategoryOccupancyStates:
                - ResourceCategoryId: 773d5e42-de1e-43a0-9ce6-f940faf2303f
                  ResourceOccupancyStates:
                  - ResourceId: f3b3b3b3-3b3b-3b3b-3b3b-3b3b3b3b3b3b
                    ResourceState: Inspected
                    OccupancyState: Reserved
                  - ResourceId: c32386aa-1cd2-414a-a823-489325842fbe
                    ResourceState: Inspected
                    OccupancyState: Vacant
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState400Example:
                  summary: Default resources_getOccupancyState 400 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState401Example:
                  summary: Default resources_getOccupancyState 401 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState403Example:
                  summary: Default resources_getOccupancyState 403 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState408Example:
                  summary: Default resources_getOccupancyState 408 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState204Example:
                  summary: Default resources_getOccupancyState 204 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState429Example:
                  summary: Default resources_getOccupancyState 429 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
              examples:
                ResourcesGetOccupancyState500Example:
                  summary: Default resources_getOccupancyState 500 response
                  x-microcks-default: true
                  value:
                    Message: string
                    RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
                    Details: string
      x-restricted: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    ResourceExtent:
      title: Resource extent
      type: object
      properties:
        Resources:
          type: boolean
          description: Whether the response should contain resources.
          nullable: true
          example: true
        ResourceCategories:
          type: boolean
          description: Whether the response should contain categories.
          nullable: true
          deprecated: true
          x-deprecatedMessage: Use [Get all resource categories](https://mews-systems.gitbook.io/connector-api/operations/resourcecategories#get-all-resource-categories)
          example: true
        ResourceCategoryAssignments:
          type: boolean
          description: Whether the response should contain assignments of the resources to categories.
          nullable: true
          deprecated: true
          x-deprecatedMessage: Use [Get all resource category assignments](https://mews-systems.gitbook.io/connector-api/operations/resourcecategories#get-all-resource-category-assignments)
          example: true
        ResourceCategoryImageAssignments:
          type: boolean
          description: Whether the response should contain assignments of the images to categories.
          nullable: true
          deprecated: true
          x-deprecatedMessage: Use [Get all resource category image assignments](https://mews-systems.gitbook.io/connector-api/operations/resourcecategories#get-all-resource-category-image-assignments)
          example: true
        ResourceFeatures:
          type: boolean
          description: Whether the response should contain resource features.
          nullable: true
          deprecated: true
          x-deprecatedMessage: Use [Get all resource features](https://mews-systems.gitbook.io/connector-api/operations/resourcefeatures#get-all-resource-features)
          example: true
        ResourceFeatureAssignments:
          type: boolean
          description: Whether the response should contain assignments of the resources to features.
          nullable: true
          deprecated: true
          x-deprecatedMessage: Use [Get all resource feature assignments](https://mews-systems.gitbook.io/connector-api/operations/resourcefeatures#get-all-resource-feature-assignments)
          example: true
        Inactive:
          type: boolean
          description: Whether the response should contain inactive entities.
          nullable: true
          example: true
      additionalProperties: false
      description: ''
      x-schema-id: ResourceExtent
    Unit:
      type: object
      additionalProperties: false
    ResourcesOccupancyStateResult:
      title: ResourcesOccupancyStateResult
      required:
      - ResourceCategoryOccupancyStates
      type: object
      properties:
        ResourceCategoryOccupancyStates:
          type: array
          items:
            $ref: '#/components/schemas/ResourceCategoryOccupancyState'
          description: The resource categories.
      additionalProperties: false
      x-schema-id: ResourcesOccupancyStateResult
    SpaceDataUpdateParameters:
      title: Space resource data update
      type: object
      properties:
        FloorNumber:
          title: String update value
          allOf:
          - $ref: '#/components/schemas/StringUpdateValue'
          description: New number of the floor the space is on.
          nullable: true
          example: '1001'
        LocationNotes:
          title: String update value
          allOf:
          - $ref: '#/components/schemas/StringUpdateValue'
          description: New location notes for the space.
          nullable: true
          example: string
      additionalProperties: false
      x-schema-id: SpaceDataUpdateParameters
    ResourcesOccupancyStateFilterParameters:
      title: ResourcesOccupancyStateFilterParameters
      required:
      - AccessToken
      - Client
      - ClientToken
      - ResourceCategoryIds
      type: object
      properties:
        ClientToken:
          minLength: 1
          type: string
          description: Token identifying the client application.
          example: string
        AccessToken:
          minLength: 1
          type: string
          description: Access token of the client application.
          example: string
        Client:
          minLength: 1
          type: string
          description: Name and version of the client application.
          example: string
        ResourceCategoryIds:
          maxItems: 5
          type: array
          items:
            type: string
            format: uuid
          description: Unique identifiers of the `ResourceCategory`.
        ResourceStates:
          type: array
          items:
            $ref: '#/components/schemas/ResourceState'
          description: States of the `Resource`
          nullable: true
        OccupancyStates:
          type: array
          items:
            $ref: '#/components/schemas/OccupancyStateEnum'
          description: Occupancy states of the `Resource`.
          nullable: true
      additionalProperties: false
      x-schema-id: ResourcesOccupancyStateFilterParameters
    Resource:
      title: Resource
      required:
      - CreatedUtc
      - Data
      - Descriptions
      - Directions
      - EnterpriseId
      - ExternalNames
      - Id
      - IsActive
      - Name
      - State
      - UpdatedUtc
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier of the resource.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        EnterpriseId:
          type: string
          description: Unique identifier of the `Enterprise`.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        IsActive:
          type: boolean
          description: Whether the resource is still active.
          example: true
        ParentResourceId:
          type: string
          description: Identifier of the parent `Resource` (e.g. room of a bed).
          format: uuid
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        Name:
          minLength: 1
          type: string
          description: Name of the resource (e.g. room number).
          example: Example Name
        State:
          $ref: '#/components/schemas/ResourceState'
        Descriptions:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the description.
          x-schema-id: LocalizedStrings
        CreatedUtc:
          minLength: 1
          type: string
          description: Creation date and time of the resource in UTC timezone in ISO 8601 format.
          example: string
        UpdatedUtc:
          minLength: 1
          type: string
          description: Last update date and time of the resource in UTC timezone in ISO 8601 format.
          example: string
        Data:
          title: Resource data
          type: object
          properties:
            Discriminator:
              $ref: '#/components/schemas/ResourceDataDiscriminator'
            Value:
              oneOf:
              - $ref: '#/components/schemas/SpaceData'
              - title: Object resource data
                type: object
                additionalProperties: false
              - title: Person resource data
                type: object
                additionalProperties: false
              description: Based on `Discriminator`. Currently present only for `Space` resources with [Space resource data](https://mews-systems.gitbook.io/connector-api/operations/resources#space-resource-data).
          description: Additional data of the resource.
          x-coproduct: true
          x-schema-id: ResourceDataCoproductOfResourceDataDiscriminator
        ExternalNames:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of external name.
          x-schema-id: LocalizedStrings
        Directions:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of direction.
          x-schema-id: LocalizedStrings
      additionalProperties: false
      x-schema-id: Resource
    ResourceDataDiscriminator:
      title: Resource data discriminator
      enum:
      - Space
      - Object
      - Person
      type: string
      description: Whether the resource is space, object, or person.
    TimeFilterInterval:
      title: Time interval
      type: object
      properties:
        StartUtc:
          type: string
          format: date-time
          nullable: true
          example: '2026-06-02T14:30:00Z'
        EndUtc:
          type: string
          format: date-time
          nullable: true
          example: '2026-06-02T14:30:00Z'
      additionalProperties: false
      description: "When a time interval is used for **filtering** (for example in parameters such as `CreatedUtc.StartUtc` / `CreatedUtc.EndUtc`), the following rules apply:\r\n\r\n- **Start equals End (equality mode)**  \r\n  If `StartUtc` and `EndUtc` are exactly the same timestamp, the filter is treated as an equality check for that precise moment in time:\r\n  \r\n  ```\r\n  CreatedUtc == StartUtc\r\n  ```\r\n  \r\n  This does not represent an interval; only records with `CreatedUtc` equal to that exact instant are returned.\r\n\r\n- **Start differs from End (interval mode)**  \r\n  If `StartUtc` and `EndUtc` are different, the filter is evaluated as a half-open interval:\r\n  \r\n  ```\r\n  StartUtc <= CreatedUtc < EndUtc\r\n  ```\r\n  \r\n  In other words, the start is inclusive and the end is exclusive.\r\n\r\nMake sure your integration takes inclusive Start / exclusive End behavior of time intervals into account so that no records at the boundaries are omitted."
      x-schema-id: TimeFilterInterval
    ResourceCategoryType:
      title: Resource category type
      enum:
      - Room
      - Bed
      - Dorm
      - Apartment
      - Suite
      - Villa
      - Site
      - Office
      - MeetingRoom
      - ParkingSpot
      - Desk
      - TeamArea
      - Membership
      - Tent
      - CaravanOrRV
      - UnequippedCampsite
      - Bike
      - ExtraBed
      - Cot
      - Crib
      - ConferenceRoom
      - Rooftop
      - Garden
      - Restaurant
      - Amphitheater
      - PrivateSpaces
      type: string
      description: Type of the category.
    ResourceFeatureClassification:
      title: Resource feature classification
      enum:
      - SeaView
      - RiverView
      - OceanView
      - TwinBeds
      - DoubleBed
      - RollawayBed
      - UpperBed
      - LowerBed
      - Balcony
      - AccessibleBathroom
      - AccessibleRoom
      - ElevatorAccess
      - HighFloor
      - Kitchenette
      - AirConditioning
      - PrivateJacuzzi
      - PrivateSauna
      - EnsuiteRoom
      - PrivateBathroom
      - SharedBathroom
      type: string
      description: Classification of `ResourceFeature`.
    ResourceFeatureAssignment:
      title: Resource feature assignment
      required:
      - CreatedUtc
      - FeatureId
      - Id
      - IsActive
      - ResourceId
      - UpdatedUtc
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier of the assignment.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        IsActive:
          type: boolean
          description: Whether the assignment is still active.
          example: true
        ResourceId:
          type: string
          description: Unique identifier of the [Resource](https://mews-systems.gitbook.io/connector-api/operations/resources/#resource).
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        FeatureId:
          type: string
          description: Unique identifier of the [Resource feature](https://mews-systems.gitbook.io/connector-api/operations/#resource-feature) assigned to the Resource.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        CreatedUtc:
          minLength: 1
          type: string
          description: Creation date and time of the assignment in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
        UpdatedUtc:
          minLength: 1
          type: string
          description: Last update date and time of the assignment in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
      additionalProperties: false
      x-schema-id: ResourceFeatureAssignment
    OccupancyStateEnum:
      title: Occupancy state
      enum:
      - Vacant
      - ReservedLocked
      - Reserved
      - InternalUse
      - OutOfOrder
      type: string
      description: 'Occupancy states of the `Resource`.


        Vacant


        ReservedLocked


        Reserved


        InternalUse


        OutOfOrder'
      x-enumNames:
      - Vacant
      - ReservedLocked
      - Reserved
      - InternalUse
      - OutOfOrder
      x-enumDescriptions:
      - ''
      - ''
      - ''
      - ''
      - ''
    ResourceCategoryImageAssignment:
      title: Resource category image assignment
      required:
      - CategoryId
      - CreatedUtc
      - Id
      - ImageId
      - IsActive
      - Ordering
      - UpdatedUtc
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier of the assignment.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        IsActive:
          type: boolean
          description: Whether the assignment is still active.
          example: true
        CategoryId:
          type: string
          description: Unique identifier of the [Resource category](https://mews-systems.gitbook.io/connector-api/operations/#resource-category).
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        ImageId:
          type: string
          description: Unique identifier of the image assigned to the Resource category.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        CreatedUtc:
          minLength: 1
          type: string
          description: Creation date and time of the assignment in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
        UpdatedUtc:
          minLength: 1
          type: string
          description: Last update date and time of the assignment in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
        Ordering:
          type: integer
          description: Ordering of the image in the resource category.
          format: int32
          example: 1
      additionalProperties: false
      x-schema-id: ResourceCategoryImageAssignment
    ResourceCategoryOccupancyState:
      title: Resource category occupancy state
      required:
      - ResourceCategoryId
      - ResourceOccupancyStates
      type: object
      properties:
        ResourceCategoryId:
          type: string
          description: Unique identifier of the 'Resource category'.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        ResourceOccupancyStates:
          type: array
          items:
            $ref: '#/components/schemas/ResourceOccupancyState'
          description: The resource occupancy states.
      additionalProperties: false
      description: The list of `ResourceOccupancyState`s grouped by resource category.
      x-schema-id: ResourceCategoryOccupancyState
    SpaceData:
      title: Space resource data
      required:
      - FloorNumber
      type: object
      properties:
        FloorNumber:
          minLength: 1
          type: string
          description: Number of the floor the space is on.
          example: '1001'
        LocationNotes:
          type: string
          description: Location notes for the space. It can be, for example, Building number the space is located in or the Parking area the particular parking space is at.
          nullable: true
          example: string
      additionalProperties: false
      x-schema-id: SpaceData
    ResourceCategoryAssignment:
      title: Resource category assignment
      required:
      - CategoryId
      - CreatedUtc
      - Id
      - IsActive
      - ResourceId
      - UpdatedUtc
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier of the assignment.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        IsActive:
          type: boolean
          description: Whether the assignment is still active.
          example: true
        ResourceId:
          type: string
          description: Unique identifier of the [Resource](https://mews-systems.gitbook.io/connector-api/operations/#resource) assigned to the Resource category.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        CategoryId:
          type: string
          description: Unique identifier of the [Resource category](https://mews-systems.gitbook.io/connector-api/operations/#resource-category).
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        CreatedUtc:
          minLength: 1
          type: string
          description: Creation date and time of the assignment in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
        UpdatedUtc:
          minLength: 1
          type: string
          description: Last update date and time of the assignment in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
      additionalProperties: false
      x-schema-id: ResourceCategoryAssignment
    ResourceCategory:
      title: Resource category
      required:
      - Capacity
      - Classification
      - Descriptions
      - EnterpriseId
      - ExtraCapacity
      - Id
      - IsActive
      - Names
      - Ordering
      - ServiceId
      - ShortNames
      - Type
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier of the category.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        EnterpriseId:
          type: string
          description: Unique identifier of the `Enterprise`.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        ServiceId:
          type: string
          description: Unique identifier of the `Service` of the resource category.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        IsActive:
          type: boolean
          description: Whether the category is still active.
          example: true
        Type:
          $ref: '#/components/schemas/ResourceCategoryType'
        Classification:
          $ref: '#/components/schemas/ResourceClassification'
        Names:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the name.
          x-schema-id: LocalizedStrings
        ShortNames:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the short name.
          x-schema-id: LocalizedStrings
        Descriptions:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the description.
          x-schema-id: LocalizedStrings
        Ordering:
          type: integer
          description: Ordering of the category, lower number corresponds to lower category (note that neither uniqueness nor continuous sequence is guaranteed).
          format: int32
          example: 1
        Capacity:
          type: integer
          description: Capacity that can be served (e.g. bed count).
          format: int32
          example: 1
        ExtraCapacity:
          type: integer
          description: Extra capacity that can be served (e.g. extra bed count).
          format: int32
          example: 1
        ExternalIdentifier:
          maxLength: 255
          type: string
          description: Identifier of the resource category from external system.
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        AccountingCategoryId:
          type: string
          description: Unique identifier of the accounting category.
          format: uuid
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
      additionalProperties: false
      x-schema-id: ResourceCategory
    ResourceOccupancyState:
      title: Resource occupancy state
      required:
      - OccupancyState
      - ResourceId
      - ResourceState
      type: object
      properties:
        ResourceId:
          type: string
          description: Unique identifier of the resource.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        ResourceState:
          title: Resource state
          allOf:
          - $ref: '#/components/schemas/ResourceState'
          description: 'Resource state of the resource.


            Dirty


            Clean


            Inspected


            OutOfService


            OutOfOrder'
          x-enumNames:
          - Dirty
          - Clean
          - Inspected
          - OutOfService
          - OutOfOrder
          x-enumDescriptions:
          - ''
          - ''
          - ''
          - ''
          - ''
          x-schema-id: ResourceState
          example: string
        OccupancyState:
          title: Occupancy state
          allOf:
          - $ref: '#/components/schemas/OccupancyStateEnum'
          description: 'State of the resource.


            Vacant


            ReservedLocked


            Reserved


            InternalUse


            OutOfOrder'
          x-enumNames:
          - Vacant
          - ReservedLocked
          - Reserved
          - InternalUse
          - OutOfOrder
          x-enumDescriptions:
          - ''
          - ''
          - ''
          - ''
          - ''
          example: string
      additionalProperties: false
      description: The occupancy state of a `Resource`.
      x-schema-id: ResourceOccupancyState
    ResourceFilterParameters:
      title: ResourceFilterParameters
      required:
      - AccessToken
      - Client
      - ClientToken
      - Extent
      - Limitation
      type: object
      properties:
        ClientToken:
          minLength: 1
          type: string
          description: Token identifying the client application.
          example: string
        AccessToken:
          minLength: 1
          type: string
          description: Access token of the client application.
          example: string
        Client:
          minLength: 1
          type: string
          description: Name and version of the client application.
          example: string
        Limitation:
          allOf:
          - $ref: '#/components/schemas/Limitation'
          description: Limitation on the quantity of data returned and optional Cursor for the starting point of data.
          example: string
        EnterpriseIds:
          maxItems: 1000
          minItems: 1
          type: array
          items:
            type: string
            format: uuid
          description: Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token.
          nullable: true
        ResourceIds:
          maxItems: 1000
          minItems: 1
          type: array
          items:
            type: string
            format: uuid
          description: Unique identifiers of the requested resources.
          nullable: true
        Names:
          maxItems: 1000
          minItems: 1
          type: array
          items:
            type: string
          description: Names of the requested resources.
          nullable: true
        Extent:
          title: Resource extent
          allOf:
          - $ref: '#/components/schemas/ResourceExtent'
          description: Extent of data to be returned.
          example: string
        CreatedUtc:
          title: Time interval
          allOf:
          - $ref: '#/components/schemas/TimeFilterInterval'
          description: Interval in which the resources were created.
          nullable: true
          x-max-interval-in-months: 3
          example: string
        UpdatedUtc:
          title: Time interval
          allOf:
          - $ref: '#/components/schemas/TimeFilterInterval'
          description: Interval in which the resources were updated.
          nullable: true
          x-max-interval-in-months: 3
          example: string
      additionalProperties: false
      x-schema-id: ResourceFilterParameters
    ResourceState:
      title: Resource state
      enum:
      - Dirty
      - Clean
      - Inspected
      - OutOfService
      - OutOfOrder
      type: string
      description: 'State of the resource.


        Dirty


        Clean


        Inspected


        OutOfService


        OutOfOrder'
      x-enumNames:
      - Dirty
      - Clean
      - Inspected
      - OutOfService
      - OutOfOrder
      x-enumDescriptions:
      - ''
      - ''
      - ''
      - ''
      - ''
      x-schema-id: ResourceState
    ResourceUpdateParameters:
      title: Resource update
      required:
      - ResourceId
      type: object
      properties:
        ResourceId:
          type: string
          description: Unique identifier of the `Resource` which is updated.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        Name:
          title: String update value
          allOf:
          - $ref: '#/components/schemas/StringUpdateValue'
          description: New name of the resource (e.g. room number).
          nullable: true
          example: Example Name
        ParentResourceId:
          title: Guid update value
          allOf:
          - $ref: '#/components/schemas/GuidNullableUpdateValue'
          description: Identifier of the new parent `Resource`.
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        Data:
          title: Resource data update
          type: object
          properties:
            Discriminator:
              $ref: '#/components/schemas/ResourceDataDiscriminator'
            Value:
              oneOf:
              - $ref: '#/components/schemas/SpaceDataUpdateParameters'
              - title: Object resource data update
                type: object
                additionalProperties: false
              - title: Person resource data update
                type: object
                additionalProperties: false
              description: Based on `Discriminator`. Currently supported only for `Space` resources with [Space resource data update](https://mews-systems.gitbook.io/connector-api/operations/resources#space-resource-data-update).
          description: New additional data of the resource.
          nullable: true
          x-coproduct: true
          x-schema-id: ResourceUpdateParametersDataCoproductOfResourceDataDiscriminator
        State:
          title: String update value
          allOf:
          - $ref: '#/components/schemas/StringUpdateValue'
          description: New `ResourceState` except `OutOfOrder`.
          nullable: true
          example: string
        StateReason:
          title: String update value
          allOf:
          - $ref: '#/components/schemas/StringUpdateValue'
          description: New reason for the state of the resource.
          nullable: true
          example: string
      additionalProperties: false
      x-schema-id: ResourceUpdateParameters
    ResourceResult:
      title: ResourceResult
      type: object
      properties:
        Resources:
          type: array
          items:
            $ref: '#/components/schemas/Resource'
          description: The resources of the enterprise.
          nullable: true
        ResourceCategories:
          type: array
          items:
            $ref: '#/components/schemas/ResourceCategory'
          description: Categories of resources in the enterprise.
          nullable: true
          deprecated: true
        ResourceCategoryAssignments:
          type: array
          items:
            $ref: '#/components/schemas/ResourceCategoryAssignment'
          description: Assignments of resources to categories.
          nullable: true
          deprecated: true
        ResourceCategoryImageAssignments:
          type: array
          items:
            $ref: '#/components/schemas/ResourceCategoryImageAssignment'
          description: Assignments of images to categories.
          nullable: true
          deprecated: true
        ResourceFeatures:
          type: array
          items:
            $ref: '#/components/schemas/ResourceFeature'
          description: Features of resources in the enterprise.
          nullable: true
          deprecated: true
        ResourceFeatureAssignments:
          type: array
          items:
            $ref: '#/components/schemas/ResourceFeatureAssignment'
          description: Assignments of resource features to resources.
          nullable: true
          deprecated: true
        Cursor:
          type: string
          description: Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. `null`, then the latest or most recent items will be returned.
          format: uuid
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
      additionalProperties: false
      x-schema-id: ResourceResult
    ConnectorApiExceptionResult:
      title: ConnectorApiExceptionResult
      type: object
      properties:
        Message:
          type: string
          nullable: true
          example: string
        RequestId:
          type: string
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        Details:
          nullable: true
          example: string
      additionalProperties: false
      x-schema-id: ConnectorApiExceptionResult
    Limitation:
      title: Limitation
      required:
      - Count
      type: object
      properties:
        Count:
          type: integer
          format: int32
          example: 1
        Cursor:
          type: string
          format: uuid
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
      additionalProperties: false
      description: Limitation on the quantity of data returned.
      x-schema-id: Limitation
    GuidNullableUpdateValue:
      title: Guid update value
      type: object
      properties:
        Value:
          type: string
          description: Value which is to be updated.
          format: uuid
          nullable: true
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
      additionalProperties: false
      x-schema-id: GuidNullableUpdateValue
    MultipleResourceUpdateParameters:
      title: MultipleResourceUpdateParameters
      required:
      - AccessToken
      - Client
      - ClientToken
      - ResourceUpdates
      type: object
      properties:
        ClientToken:
          minLength: 1
          type: string
          description: Token identifying the client application.
          example: string
        AccessToken:
          minLength: 1
          type: string
          description: Access token of the client application.
          example: string
        Client:
          minLength: 1
          type: string
          description: Name and version of the client application.
          example: string
        ResourceUpdates:
          maxItems: 1000
          minItems: 1
          type: array
          items:
            $ref: '#/components/schemas/ResourceUpdateParameters'
          description: Resource updates.
      additionalProperties: false
      x-schema-id: MultipleResourceUpdateParameters
    ResourceFeature:
      title: Resource feature
      required:
      - Classification
      - CreatedUtc
      - Descriptions
      - Id
      - IsActive
      - Names
      - ServiceId
      - ShortNames
      - UpdatedUtc
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier of `ResourceFeature`.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        ServiceId:
          type: string
          description: Unique identifier of `Service` the resource feature belongs to.
          format: uuid
          example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111
        IsActive:
          type: boolean
          description: Whether the `ResourceFeature` is active.
          example: true
        Classification:
          $ref: '#/components/schemas/ResourceFeatureClassification'
        Names:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the name.
          x-schema-id: LocalizedStrings
        ShortNames:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the short name.
          x-schema-id: LocalizedStrings
        Descriptions:
          title: Localized text
          type: object
          additionalProperties:
            type: string
          description: All translations of the description.
          x-schema-id: LocalizedStrings
        CreatedUtc:
          minLength: 1
          type: string
          description: Creation date and time of the resource feature in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
        UpdatedUtc:
          minLength: 1
          type: string
          description: Last update date and time of the resource feature in UTC timezone in ISO 8601 format.
          format: date-time
          example: '2026-06-02T14:30:00Z'
      additionalProperties: false
      x-schema-id: ResourceFeature
    StringUpdateValue:
      title: String update value
      type: object
      properties:
        Value:
          type: string
          description: Value which is to be updated.
          nullable: true
          example: string
      additionalProperties: false
      x-schema-id: StringUpdateValue
    ResourceClassification:
      title: Resource classification
      enum:
      - StandardSingle
      - StandardDouble
      - SuperiorTwin
      - SuperiorDouble
      - JuniorSuite
      - SharedOrDorm
      - Other
      - SuperiorSingle
      - Triple
      - Family
      - StandardTwin
      - Studio
      - SuperiorTripleRoom
      - OneBedroomApartment
      - ThreeBedroomsApartment
      - TwoBedroomsApartment
      type: string
      description: Classification of the resource category.
  securitySchemes:
    MewsClientToken:
      type: apiKey
      in: header
      name: ClientToken
      description: Mews authentication is performed by supplying ClientToken, AccessToken and Client as fields in the JSON request body (not as HTTP headers). This securityScheme is a tooling-compatible representation of the ClientToken credential. ClientToken is unique to your application and identifies the API client.
    MewsAccessToken:
      type: apiKey
      in: header
      name: AccessToken
      description: Tooling-compatible representation of the AccessToken credential, which is supplied in the JSON request body. AccessToken is unique to the connection with a property (enterprise) and identifies the property or properties whose data and services you can access. Portfolio Access Tokens enable multi-property access with a single token.