> ## 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 realized action savings

> 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`. Set `return_sql` to see the SQL the rows came from.



## OpenAPI

````yaml https://api.select.dev/v2/openapi.json post /metrics/action-realized-savings/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:
  /metrics/action-realized-savings/query:
    post:
      tags:
        - metrics
      summary: Query realized action savings
      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`. Set `return_sql` to see the
        SQL the rows came from.
      operationId: query_realized_savings_route_metrics_action_realized_savings_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/ActionRealizedSavingsQuery'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryResponse_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:
    ActionRealizedSavingsQuery:
      properties:
        measures:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/SemiStructuredMeasure_DailyActionSavingsDimensions_
              - $ref: '#/components/schemas/DailyActionSavingsMeasures'
          type: array
          title: Measures
          description: Aggregates to compute over the matching rows.
        dimensions:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
              - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          type: array
          title: Dimensions
          description: Columns to group the aggregates by. Each is returned on every row.
        filter_expression:
          anyOf:
            - $ref: >-
                #/components/schemas/FilterExpression_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
            - type: 'null'
          description: >-
            An `and`/`or` tree of predicates over dimensions, applied before
            aggregation. Omit to match every row the caller can see.
        measure_filters:
          items:
            anyOf:
              - $ref: '#/components/schemas/InFilter_DailyActionSavingsMeasures_'
              - $ref: >-
                  #/components/schemas/ArrayContainsFilter_DailyActionSavingsMeasures_
              - $ref: '#/components/schemas/IsFilter_DailyActionSavingsMeasures_'
              - $ref: '#/components/schemas/LikeFilter_DailyActionSavingsMeasures_'
              - $ref: >-
                  #/components/schemas/MultiLikeFilter_DailyActionSavingsMeasures_
              - $ref: '#/components/schemas/EqFilter_DailyActionSavingsMeasures_'
              - $ref: >-
                  #/components/schemas/FilterExpression_DailyActionSavingsMeasures_
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_DailyActionSavingsMeasures_
          type: array
          title: Measure Filters
          description: Predicates over measures, applied after aggregation.
        sort:
          items:
            $ref: >-
              #/components/schemas/Sort_DailyActionSavingsMeasures_DailyActionSavingsDimensions_
          type: array
          title: Sort
          description: Ordering applied to the aggregated rows.
        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: 1000
        return_sql:
          type: boolean
          title: Return Sql
          description: >-
            Return the SQL that produced the rows alongside them, for inspecting
            how a result was computed. Not every query endpoint publishes its
            SQL; where it does not, the field stays null.
          default: false
      additionalProperties: false
      type: object
      title: ActionRealizedSavingsQuery
      description: >-
        Aggregate the savings actions have realized, day by day.


        Rows are already scoped to the teams the caller may see. To narrow
        further to

        specific teams, filter on the `team_id` dimension.
    QueryResponse_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.
        sql:
          anyOf:
            - type: string
            - type: 'null'
          title: Sql
          description: >-
            The SQL that produced these rows, returned only when the request
            asks for it. Database and schema names are left as placeholders.
            Null when the request did not ask for it, or when this endpoint does
            not publish its SQL.
      type: object
      required:
        - items
      title: QueryResponse[dict[str, Any]]
    SemiStructuredMeasure_DailyActionSavingsDimensions_:
      properties:
        aggregate_function:
          type: string
          const: array_unique_agg
          title: Aggregate Function
        dimension:
          $ref: >-
            #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
      type: object
      required:
        - aggregate_function
        - dimension
      title: SemiStructuredMeasure[DailyActionSavingsDimensions]
    DailyActionSavingsMeasures:
      type: string
      enum:
        - sum_savings
        - sum_daily_spend
        - sum_tgs_savings
        - count_days
        - avg_daily_savings
        - cumulative_savings
        - sum_apc_downscale_savings
        - sum_apc_cap_savings
        - sum_jcss_downscale_savings
        - sum_jcss_cap_savings
    SemiStructuredDimension_DailyActionSavingsDimensions_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsDimensions'
        path:
          items:
            type: string
          type: array
          title: Path
      type: object
      required:
        - field
        - path
      title: SemiStructuredDimension[DailyActionSavingsDimensions]
    DailyActionSavingsDimensions:
      type: string
      enum:
        - day
        - day_of_week
        - day_of_month
        - quarter
        - week
        - month
        - action_id
        - calculation_method
        - team_id
        - is_calibrating
    FilterExpression_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        operator:
          type: string
          enum:
            - and
            - or
          title: Operator
        filters:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/FilterExpression_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/EqFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/InFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/ArrayContainsFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/IsFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/LikeFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/MultiLikeFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    InFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    ArrayContainsFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    IsFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    LikeFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    MultiLikeFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    EqFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    FilterExpression_DailyActionSavingsMeasures_:
      properties:
        operator:
          type: string
          enum:
            - and
            - or
          title: Operator
        filters:
          items:
            anyOf:
              - $ref: >-
                  #/components/schemas/FilterExpression_DailyActionSavingsMeasures_
              - $ref: '#/components/schemas/EqFilter_DailyActionSavingsMeasures_'
              - $ref: '#/components/schemas/InFilter_DailyActionSavingsMeasures_'
              - $ref: >-
                  #/components/schemas/ArrayContainsFilter_DailyActionSavingsMeasures_
              - $ref: '#/components/schemas/IsFilter_DailyActionSavingsMeasures_'
              - $ref: '#/components/schemas/LikeFilter_DailyActionSavingsMeasures_'
              - $ref: >-
                  #/components/schemas/MultiLikeFilter_DailyActionSavingsMeasures_
              - $ref: >-
                  #/components/schemas/InRelativeDateRangeFilter_DailyActionSavingsMeasures_
          type: array
          title: Filters
        component_type:
          anyOf:
            - type: string
              const: Resource Filter
            - type: 'null'
          title: Component Type
      type: object
      required:
        - operator
        - filters
      title: FilterExpression[DailyActionSavingsMeasures]
    InRelativeDateRangeFilter_DailyActionSavingsMeasures_:
      properties:
        field:
          $ref: '#/components/schemas/DailyActionSavingsMeasures'
        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[DailyActionSavingsMeasures]
    Sort_DailyActionSavingsMeasures_DailyActionSavingsDimensions_:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
            - $ref: >-
                #/components/schemas/SemiStructuredMeasure_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsMeasures'
          title: Field
        direction:
          type: string
          enum:
            - asc
            - desc
          title: Direction
        column_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Column Key
      type: object
      required:
        - field
        - direction
      title: Sort[DailyActionSavingsMeasures, DailyActionSavingsDimensions]
    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
    EqFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    InFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    ArrayContainsFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    IsFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    LikeFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    MultiLikeFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
    InRelativeDateRangeFilter_Union_SemiStructuredDimension_DailyActionSavingsDimensions___DailyActionSavingsDimensions__:
      properties:
        field:
          anyOf:
            - $ref: >-
                #/components/schemas/SemiStructuredDimension_DailyActionSavingsDimensions_
            - $ref: '#/components/schemas/DailyActionSavingsDimensions'
          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[DailyActionSavingsDimensions],
        DailyActionSavingsDimensions]]
  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

````