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

# Query insights by dimension and measure

> Returns one row per combination of the requested dimensions, carrying the requested measures. Each row is keyed by dimension and measure name. `row_count` is the number of rows in `items`: results are not paginated, so an aggregation with more rows than `limit` is cut short at `limit` rather than continued under a `page_token`.



## OpenAPI

````yaml https://api.select.dev/v2/openapi.json post /insights/actions/query
openapi: 3.1.0
info:
  title: SELECT API (v2)
  version: 0.1.0
servers:
  - url: https://api.select.dev/v2
    description: SELECT API v2
security: []
paths:
  /insights/actions/query:
    post:
      tags:
        - insights
      summary: Query insights by dimension and measure
      description: >-
        Returns one row per combination of the requested dimensions, carrying
        the requested measures. Each row is keyed by dimension and measure name.
        `row_count` is the number of rows in `items`: results are not paginated,
        so an aggregation with more rows than `limit` is cut short at `limit`
        rather than continued under a `page_token`.
      operationId: query_insights_route_insights_actions_query_post
      parameters:
        - name: x-tenant-id
          in: header
          required: true
          schema:
            type: string
            description: The organization ID the request is scoped to.
            title: X-Tenant-Id
          description: The organization ID the request is scoped to.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InsightQuery'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse_dict_str__Any__'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
        '408':
          $ref: '#/components/responses/RequestTimeout'
        '409':
          $ref: '#/components/responses/Conflict'
        '422':
          $ref: '#/components/responses/ValidationFailed'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - HTTPBearer: []
components:
  schemas:
    InsightQuery:
      properties:
        measures:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/SemiStructuredMeasure_InsightDimensionName_
              - $ref: '#/components/schemas/InsightMeasureName'
          type: array
          title: Measures
        dimensions:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/SemiStructuredDimension_InsightDimensionName_
              - $ref: '#/components/schemas/InsightDimensionName'
          type: array
          title: Dimensions
        filters:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/InFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/ArrayContainsFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/IsFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/LikeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/MultiLikeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/EqFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/FilterExpression_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
          type: array
          title: Filters
        filter_expression:
          anyOf:
            - $ref: >-
                #/components/schemas/FilterExpression_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
            - type: 'null'
        measure_filters:
          items:
            anyOf:
              - $ref: '#/components/schemas/InFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/ArrayContainsFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/IsFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/LikeFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/MultiLikeFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/EqFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/FilterExpression_InsightMeasureName_'
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_InsightMeasureName_
          type: array
          title: Measure Filters
        sort:
          items:
            $ref: '#/components/schemas/Sort_InsightMeasureName_InsightDimensionName_'
          type: array
          title: Sort
        limit:
          type: integer
          maximum: 10000
          minimum: 1
          title: Limit
          description: >-
            Maximum rows to return, at most 10000. An aggregation that produces
            more rows than this is silently cut short at the limit, so narrow
            the filters or group by fewer dimensions rather than raising it to
            see everything.
          default: 10000
      additionalProperties: false
      type: object
      title: InsightQuery
      description: >-
        An aggregate query over insights.


        Group with `dimensions`, aggregate with `measures`, narrow rows with
        `filters` or

        `filter_expression`, and narrow aggregates with `measure_filters`. Rows
        are already

        limited to the insights the caller may see.
    ListResponse_dict_str__Any__:
      properties:
        items:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Items
        page_token:
          anyOf:
            - type: string
            - type: 'null'
          title: Page Token
          description: Opaque cursor for the next page; empty/absent on the last page.
        row_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Row Count
          description: >-
            Best-effort total for the filtered result set; may be null when
            expensive.
      type: object
      required:
        - items
      title: ListResponse[dict[str, Any]]
    SemiStructuredMeasure_InsightDimensionName_:
      properties:
        aggregate_function:
          type: string
          const: array_unique_agg
          title: Aggregate Function
        dimension:
          $ref: '#/components/schemas/SemiStructuredDimension_InsightDimensionName_'
      type: object
      required:
        - aggregate_function
        - dimension
      title: SemiStructuredMeasure[InsightDimensionName]
    InsightMeasureName:
      type: string
      enum:
        - count
        - num_insights
        - sum_annualized_potential_savings_lower_bound
        - sum_annualized_potential_savings_upper_bound
        - sum_unique_annualized_potential_savings_lower_bound
        - sum_unique_annualized_potential_savings_upper_bound
        - avg_annualized_potential_savings_lower_bound
        - avg_annualized_potential_savings_upper_bound
        - sum_effective_annualized_potential_savings_lower_bound
        - sum_effective_annualized_potential_savings_upper_bound
        - sum_unique_effective_annualized_potential_savings_lower_bound
        - sum_unique_effective_annualized_potential_savings_upper_bound
        - num_resources
        - min_studied_period_start
        - max_studied_period_end
      title: InsightMeasureName
    SemiStructuredDimension_InsightDimensionName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightDimensionName'
        path:
          items:
            type: string
          type: array
          title: Path
      type: object
      required:
        - field
        - path
      title: SemiStructuredDimension[InsightDimensionName]
    InsightDimensionName:
      type: string
      enum:
        - identifying_metadata
        - aggregate_metadata
        - insight_metadata
        - insight_type
        - collapsed_insight_type
        - resource_type
        - nice_resource_type
        - aggregate_resource_type
        - effort
        - effort_sort_index
        - user_effort
        - effective_effort
        - effective_effort_sort_index
        - status
        - assignee
        - connection_id
        - is_current
        - is_dismissed
        - account_metadata
        - sf_account
        - sf_org
        - usage_groups
        - usage_group
        - connection_type
        - platform_organization
        - platform_instance
        - platform_instance_name
        - snowflake_account_name
        - snowflake_org_name
        - databricks_account_id
        - databricks_workspace_id
        - first_generated_at
        - first_generated_day
        - last_generated_at
        - studied_period_start
        - studied_period_end
        - latest_query_start_time
        - nice_identifying_metadata
        - id
        - etag
        - snowflake_id
        - other_insights_for_resource
        - annualized_potential_savings_lower_bound
        - annualized_potential_savings_upper_bound
        - user_annualized_potential_savings_lower_bound
        - user_annualized_potential_savings_upper_bound
        - effective_annualized_potential_savings_lower_bound
        - effective_annualized_potential_savings_upper_bound
      title: InsightDimensionName
    InFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        values:
          items:
            anyOf:
              - type: integer
              - type: number
              - type: boolean
              - type: string
              - type: string
                format: date
              - additionalProperties:
                  anyOf:
                    - type: integer
                    - type: number
                    - type: boolean
                    - type: string
                    - type: string
                      format: date
                    - items:
                        anyOf:
                          - type: integer
                          - type: number
                          - type: boolean
                          - type: string
                          - type: string
                            format: date
                          - type: 'null'
                      type: array
                    - type: 'null'
                type: object
              - type: 'null'
          type: array
          title: Values
        operator:
          type: string
          enum:
            - in
            - not in
          title: Operator
      type: object
      required:
        - field
        - values
        - operator
      title: >-
        InFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    ArrayContainsFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        values:
          items:
            anyOf:
              - type: integer
              - type: number
              - type: boolean
              - type: string
              - type: string
                format: date
              - additionalProperties:
                  anyOf:
                    - type: integer
                    - type: number
                    - type: boolean
                    - type: string
                    - type: string
                      format: date
                    - items:
                        anyOf:
                          - type: integer
                          - type: number
                          - type: boolean
                          - type: string
                          - type: string
                            format: date
                          - type: 'null'
                      type: array
                    - type: 'null'
                type: object
              - type: 'null'
          type: array
          title: Values
        operator:
          type: string
          const: array_contains
          title: Operator
      type: object
      required:
        - field
        - values
        - operator
      title: >-
        ArrayContainsFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    IsFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        value:
          type: 'null'
          title: Value
        operator:
          type: string
          enum:
            - is
            - is not
          title: Operator
      type: object
      required:
        - field
        - operator
      title: >-
        IsFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    LikeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        value:
          type: string
          title: Value
        operator:
          type: string
          enum:
            - ilike
            - startswith
            - array_contains_prefix
            - array_contains_substring
          title: Operator
      type: object
      required:
        - field
        - value
        - operator
      title: >-
        LikeFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    MultiLikeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        values:
          items:
            type: string
          type: array
          title: Values
        operator:
          type: string
          enum:
            - ilike
            - startswith
          title: Operator
      type: object
      required:
        - field
        - values
        - operator
      title: >-
        MultiLikeFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    EqFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        value:
          anyOf:
            - type: integer
            - type: number
            - type: boolean
            - type: string
            - type: string
              format: date
            - additionalProperties:
                anyOf:
                  - type: integer
                  - type: number
                  - type: boolean
                  - type: string
                  - type: string
                    format: date
                  - items:
                      anyOf:
                        - type: integer
                        - type: number
                        - type: boolean
                        - type: string
                        - type: string
                          format: date
                        - type: 'null'
                    type: array
                  - type: 'null'
              type: object
            - type: 'null'
          title: Value
        operator:
          type: string
          enum:
            - '>'
            - '>='
            - <
            - <=
            - '='
            - '!='
          title: Operator
      type: object
      required:
        - field
        - value
        - operator
      title: >-
        EqFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    FilterExpression_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        operator:
          type: string
          enum:
            - and
            - or
          title: Operator
        filters:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/FilterExpression_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/EqFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/InFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/ArrayContainsFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/IsFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/LikeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/MultiLikeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__
          type: array
          title: Filters
        component_type:
          anyOf:
            - type: string
              const: Resource Filter
            - type: 'null'
          title: Component Type
      type: object
      required:
        - operator
        - filters
      title: >-
        FilterExpression[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    InRelativeDateRangeFilter_Union_SemiStructuredDimension_InsightDimensionName___InsightDimensionName__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
          title: Field
        not:
          type: boolean
          title: Not
          default: false
        value:
          type: string
          title: Value
        operator:
          type: string
          enum:
            - in range
            - not in range
          title: Operator
      type: object
      required:
        - field
        - value
        - operator
      title: >-
        InRelativeDateRangeFilter[Union[SemiStructuredDimension[InsightDimensionName],
        InsightDimensionName]]
    InFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        values:
          items:
            anyOf:
              - type: integer
              - type: number
              - type: boolean
              - type: string
              - type: string
                format: date
              - additionalProperties:
                  anyOf:
                    - type: integer
                    - type: number
                    - type: boolean
                    - type: string
                    - type: string
                      format: date
                    - items:
                        anyOf:
                          - type: integer
                          - type: number
                          - type: boolean
                          - type: string
                          - type: string
                            format: date
                          - type: 'null'
                      type: array
                    - type: 'null'
                type: object
              - type: 'null'
          type: array
          title: Values
        operator:
          type: string
          enum:
            - in
            - not in
          title: Operator
      type: object
      required:
        - field
        - values
        - operator
      title: InFilter[InsightMeasureName]
    ArrayContainsFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        values:
          items:
            anyOf:
              - type: integer
              - type: number
              - type: boolean
              - type: string
              - type: string
                format: date
              - additionalProperties:
                  anyOf:
                    - type: integer
                    - type: number
                    - type: boolean
                    - type: string
                    - type: string
                      format: date
                    - items:
                        anyOf:
                          - type: integer
                          - type: number
                          - type: boolean
                          - type: string
                          - type: string
                            format: date
                          - type: 'null'
                      type: array
                    - type: 'null'
                type: object
              - type: 'null'
          type: array
          title: Values
        operator:
          type: string
          const: array_contains
          title: Operator
      type: object
      required:
        - field
        - values
        - operator
      title: ArrayContainsFilter[InsightMeasureName]
    IsFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        value:
          type: 'null'
          title: Value
        operator:
          type: string
          enum:
            - is
            - is not
          title: Operator
      type: object
      required:
        - field
        - operator
      title: IsFilter[InsightMeasureName]
    LikeFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        value:
          type: string
          title: Value
        operator:
          type: string
          enum:
            - ilike
            - startswith
            - array_contains_prefix
            - array_contains_substring
          title: Operator
      type: object
      required:
        - field
        - value
        - operator
      title: LikeFilter[InsightMeasureName]
    MultiLikeFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        values:
          items:
            type: string
          type: array
          title: Values
        operator:
          type: string
          enum:
            - ilike
            - startswith
          title: Operator
      type: object
      required:
        - field
        - values
        - operator
      title: MultiLikeFilter[InsightMeasureName]
    EqFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        value:
          anyOf:
            - type: integer
            - type: number
            - type: boolean
            - type: string
            - type: string
              format: date
            - additionalProperties:
                anyOf:
                  - type: integer
                  - type: number
                  - type: boolean
                  - type: string
                  - type: string
                    format: date
                  - items:
                      anyOf:
                        - type: integer
                        - type: number
                        - type: boolean
                        - type: string
                        - type: string
                          format: date
                        - type: 'null'
                    type: array
                  - type: 'null'
              type: object
            - type: 'null'
          title: Value
        operator:
          type: string
          enum:
            - '>'
            - '>='
            - <
            - <=
            - '='
            - '!='
          title: Operator
      type: object
      required:
        - field
        - value
        - operator
      title: EqFilter[InsightMeasureName]
    FilterExpression_InsightMeasureName_:
      properties:
        operator:
          type: string
          enum:
            - and
            - or
          title: Operator
        filters:
          items:
            anyOf:
              - $ref: '#/components/schemas/FilterExpression_InsightMeasureName_'
              - $ref: '#/components/schemas/EqFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/InFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/ArrayContainsFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/IsFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/LikeFilter_InsightMeasureName_'
              - $ref: '#/components/schemas/MultiLikeFilter_InsightMeasureName_'
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_InsightMeasureName_
          type: array
          title: Filters
        component_type:
          anyOf:
            - type: string
              const: Resource Filter
            - type: 'null'
          title: Component Type
      type: object
      required:
        - operator
        - filters
      title: FilterExpression[InsightMeasureName]
    InRelativeDateRangeFilter_InsightMeasureName_:
      properties:
        field:
          $ref: '#/components/schemas/InsightMeasureName'
        not:
          type: boolean
          title: Not
          default: false
        value:
          type: string
          title: Value
        operator:
          type: string
          enum:
            - in range
            - not in range
          title: Operator
      type: object
      required:
        - field
        - value
        - operator
      title: InRelativeDateRangeFilter[InsightMeasureName]
    Sort_InsightMeasureName_InsightDimensionName_:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_InsightDimensionName_
            - $ref: '#/components/schemas/InsightDimensionName'
            - $ref: '#/components/schemas/SemiStructuredMeasure_InsightDimensionName_'
            - $ref: '#/components/schemas/InsightMeasureName'
          title: Field
        direction:
          type: string
          enum:
            - asc
            - desc
          title: Direction
      type: object
      required:
        - field
        - direction
      title: Sort[InsightMeasureName, InsightDimensionName]
    ProblemDetail:
      additionalProperties: true
      description: >-
        RFC 9457-style error payload, served as ``application/problem+json``.


        ``code`` is the stable, machine-readable identifier — consumers branch
        on it,

        never on ``title``. ``type`` stays ``about:blank``: we keep no per-error

        documentation pages. There is no ``instance``/request-id member (we
        don't run

        access logs). See the flat error-code catalogue in §4 of the standards
        doc.
      properties:
        type:
          default: about:blank
          title: Type
          type: string
        title:
          type: string
          title: Title
        status:
          title: Status
          type: integer
        detail:
          title: Detail
          type: string
        code:
          title: Code
          type: string
        retryable:
          title: Retryable
          type: boolean
        details:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          default: null
          title: Details
      required:
        - title
        - status
        - detail
        - code
        - retryable
      title: ProblemDetail
      type: object
  responses:
    BadRequest:
      description: Bad request
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    Unauthorized:
      description: Unauthorized
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        WWW-Authenticate:
          description: Authentication challenge for the requested resource.
          required: true
          schema:
            type: string
    Forbidden:
      description: Forbidden
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    NotFound:
      description: Not found
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    MethodNotAllowed:
      description: Method not allowed
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        Allow:
          description: HTTP methods supported by the requested resource.
          required: true
          schema:
            type: string
    RequestTimeout:
      description: Request Timeout
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    Conflict:
      description: Conflict
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    ValidationFailed:
      description: Validation failed
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    RateLimited:
      description: Rate limited
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          required: true
          schema:
            type: integer
            minimum: 0
    InternalError:
      description: Internal error
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    ServiceUnavailable:
      description: Service unavailable
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          required: true
          schema:
            type: integer
            minimum: 0
  securitySchemes:
    HTTPBearer:
      type: http
      description: Organization API key (sl_…).
      scheme: bearer

````