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

# Preview adding alerts to a claim

> Says which selected alerts would join a claim, by verdict, and why the others would not, changing nothing. Send agreement_id for a new claim (POST /v1/claims) or claim_id for a pending or in-progress one (POST /v1/alerts/update with claim_id), with the alerts object POST /v1/claims takes (at most 5000 alerts). The preview applies those commands' rules, but where the commands refuse alert_ids that cannot join, it counts them under left_out. To add exactly what was previewed, send the joining_alert_ids you want as alert_ids: a claim asks only for confirmed alerts, so the app leaves the false alarms out. Alerts can change before you send the command; it then applies its own rules.



## OpenAPI

````yaml /openapi.json post /v1/claims/alerts/preview
openapi: 3.1.0
info:
  title: Watchdog API
  version: 1.0.0
  description: >-
    The Watchdog API is served from https://api.watchdog.no. Request bodies are
    limited to 2 MiB unless an endpoint says otherwise. Files are uploaded
    directly to storage, not through the API.
servers:
  - url: https://api.watchdog.no
    description: Watchdog API
security: []
paths:
  /v1/claims/alerts/preview:
    post:
      tags:
        - Claims
      summary: Preview adding alerts to a claim
      description: >-
        Says which selected alerts would join a claim, by verdict, and why the
        others would not, changing nothing. Send agreement_id for a new claim
        (POST /v1/claims) or claim_id for a pending or in-progress one (POST
        /v1/alerts/update with claim_id), with the alerts object POST /v1/claims
        takes (at most 5000 alerts). The preview applies those commands' rules,
        but where the commands refuse alert_ids that cannot join, it counts them
        under left_out. To add exactly what was previewed, send the
        joining_alert_ids you want as alert_ids: a claim asks only for confirmed
        alerts, so the app leaves the false alarms out. Alerts can change before
        you send the command; it then applies its own rules.
      operationId: previewClaimAlerts
      parameters:
        - name: X-Organization-Id
          in: header
          required: false
          schema:
            type: string
          description: >-
            The organization to act in. Required for personal API keys; list the
            organizations you can access with GET /v1/organizations.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                agreement_id:
                  type: string
                  format: uuid
                  description: >-
                    Preview a new claim of this agreement: what POST /v1/claims
                    would add.
                claim_id:
                  type: string
                  format: uuid
                  description: >-
                    Preview this pending or in-progress claim: what POST
                    /v1/alerts/update with claim_id would add (accept_alerts
                    standing for verdict accepted).
                alerts:
                  type: object
                  properties:
                    alert_ids:
                      type: array
                      items:
                        type: string
                        format: uuid
                      minItems: 1
                      maxItems: 5000
                      description: >-
                        Alerts to change. If any is unknown (404) or cannot be
                        changed (409), nothing changes.
                    filter:
                      $ref: '#/components/schemas/AlertFilter'
                    excluded_alert_ids:
                      type: array
                      items:
                        type: string
                        format: uuid
                      minItems: 1
                      maxItems: 5000
                      description: >-
                        Alerts to leave out of a filter selection. Only valid
                        with filter.
                    move_from_open_claims:
                      type: boolean
                      description: >-
                        Move alerts out of pending or in-progress claims. Alerts
                        in cancelled claims always move; those in completed
                        claims never do.
                    accept_alerts:
                      type: boolean
                      description: >-
                        Also confirm every added alert: its verdict becomes
                        accepted whatever it was, false alarms included. Without
                        it no verdict changes. Credit is always kept.
                  additionalProperties: false
                  description: >-
                    The alerts object POST /v1/claims takes: a selection,
                    move_from_open_claims and accept_alerts.
              required:
                - alerts
              additionalProperties: false
      responses:
        '200':
          description: >-
            The alerts that would join, by verdict, and those left out, by
            reason.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaimAlertsPreview'
        '400':
          description: >-
            The request is invalid. details lists up to 20 field errors. Request
            bodies are limited to 2 MiB.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: >-
                    The request is invalid. details lists up to 20 field errors.
                    Request bodies are limited to 2 MiB.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_validation_error'
        '401':
          description: The bearer token is missing or invalid.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
            WWW-Authenticate:
              schema:
                type: string
              required: false
              description: Bearer authentication challenge, when supplied.
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: The bearer token is missing or invalid.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_invalid_token'
        '403':
          description: >-
            Access denied. The error code says why: forbidden, token_disabled,
            organization_required, insufficient_role or mfa_required.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
          content:
            application/json:
              example:
                error:
                  code: forbidden
                  message: >-
                    Access denied. The error code says why: forbidden,
                    token_disabled, organization_required, insufficient_role or
                    mfa_required.
                  request_id: req_example
              schema:
                $ref: >-
                  #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required
        '404':
          description: >-
            The agreement, the claim, an alert in alerts.alert_ids or a selected
            View was not found.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
          content:
            application/json:
              example:
                error:
                  code: not_found
                  message: >-
                    The agreement, the claim, an alert in alerts.alert_ids or a
                    selected View was not found.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_not_found'
        '409':
          description: >-
            The agreement cannot receive new claims (it is deleted, or neither
            active nor archived), the claim is not pending or in progress, more
            than 5000 alerts would join, or a selected View has invalid saved
            filters.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
          content:
            application/json:
              example:
                error:
                  code: conflict
                  message: >-
                    The agreement cannot receive new claims (it is deleted, or
                    neither active nor archived), the claim is not pending or in
                    progress, more than 5000 alerts would join, or a selected
                    View has invalid saved filters.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_conflict'
        '429':
          description: Too many requests. Wait for the Retry-After delay before retrying.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
            Retry-After:
              schema:
                type: string
                example: '60'
              required: true
              description: Seconds to wait before retrying the request.
          content:
            application/json:
              example:
                error:
                  code: rate_limit_exceeded
                  message: >-
                    Too many requests. Wait for the Retry-After delay before
                    retrying.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_rate_limit_exceeded'
        '500':
          description: >-
            Unexpected server failure. Include the request ID when contacting
            support.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
          content:
            application/json:
              example:
                error:
                  code: internal_error
                  message: >-
                    Unexpected server failure. Include the request ID when
                    contacting support.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_internal_error'
        '503':
          description: >-
            Temporarily unavailable. Retry after the Retry-After delay, when
            provided.
          headers:
            X-Request-Id:
              schema:
                type: string
              required: true
              description: >-
                Request ID, also included in error bodies. Include it when
                contacting support.
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
                  - private, no-store, no-transform
              required: false
              description: API responses are private and must not be cached.
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
              required: false
              description: >-
                Requests allowed per minute for this credential, or failed API
                key attempts allowed per minute from this IP address.
            Retry-After:
              schema:
                type: string
                example: '60'
              required: true
              description: Seconds to wait before retrying the request.
          content:
            application/json:
              example:
                error:
                  code: service_unavailable
                  message: >-
                    Temporarily unavailable. Retry after the Retry-After delay,
                    when provided.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_service_unavailable'
      security:
        - ApiKeyBearer: []
components:
  schemas:
    AlertFilter:
      type: object
      properties:
        view_ids:
          type: array
          items:
            type: string
        claim_ids:
          type: array
          items:
            type: string
        has_claim:
          type: boolean
          description: Attached to a claim now.
        claim_statuses:
          type: array
          items:
            type: string
            enum:
              - pending
              - in_progress
              - completed
              - cancelled
          description: Of the current claim.
        invoice_ids:
          type: array
          items:
            type: string
            format: uuid
        company_ids:
          type: array
          items:
            type: string
            format: uuid
          description: >-
            Alerts on invoices of these workspace companies: a company scope,
            applied to every alert whatever join_operator says.
        agreement_ids:
          type: array
          items:
            type: string
            format: uuid
        purchase_order_ids:
          type: array
          items:
            type: string
            format: uuid
          description: Alerts of purchase-order checks against these orders.
        agreement_statuses:
          type: array
          items:
            type: string
            enum:
              - draft
              - active
              - archived
        supplier_ids:
          type: array
          items:
            type: string
            format: uuid
        recipient_ids:
          type: array
          items:
            type: string
            format: uuid
        tag_ids:
          type: array
          items:
            type: string
            format: uuid
          description: Tags of the agreement.
        topic_ids:
          type: array
          items:
            type: string
        has_topic:
          type: boolean
        check_types:
          type: array
          items:
            type: string
            enum:
              - agreement
              - purchase_order
              - duplicate
        verdicts:
          type: array
          items:
            type: string
            enum:
              - pending
              - accepted
              - dismissed
              - skipped
          description: >-
            Whatever the credit. pending: to review; accepted: confirmed;
            dismissed: false alarm; skipped: unsure. Reviewed: all but pending.
        credited:
          type: boolean
          description: Whatever the verdict.
        confidence_levels:
          type: array
          items:
            type: string
            enum:
              - certain
              - uncertain
              - 'null'
        currency_codes:
          type: array
          items:
            type: string
            pattern: ^[A-Z]{3}$
        correction_types:
          type: array
          items:
            type: string
            enum:
              - modify_item
              - modify_invoice
              - add_item
        agreement_version_status:
          type: string
          enum:
            - current
            - older
          description: >-
            The alert assessed the current agreement version or an older one; an
            unknown version or no agreement matches neither.
        validity:
          type: string
          enum:
            - live
            - invalidated
            - all
          description: >-
            live (default): alerts that count; invalidated: those that stopped
            (invalidation.reason says why). Alerts in claims named by claim_ids
            are included either way.
        impact_min:
          type: string
          maxLength: 100
          pattern: ^-?\d+(?:\.\d+)?$
          description: >-
            Impact in the organization currency, inclusive. Alerts without one
            never match.
        impact_max:
          type: string
          maxLength: 100
          pattern: ^-?\d+(?:\.\d+)?$
        issued_from:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
          description: Invoice issue date.
        issued_through:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
        created_from:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
        created_through:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
        search:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            Alert, invoice, supplier, agreement and topic text. A UUID matches
            the alert, invoice, supplier or agreement ID.
        join_operator:
          type: string
          enum:
            - and
            - or
          description: >-
            or combines only the invoice, agreement, supplier, recipient and
            topic IDs.
        not:
          type: array
          items:
            type: string
            enum:
              - claim_ids
              - claim_statuses
              - invoice_ids
              - agreement_ids
              - purchase_order_ids
              - agreement_statuses
              - supplier_ids
              - recipient_ids
              - tag_ids
              - topic_ids
              - check_types
              - verdicts
              - confidence_levels
              - currency_codes
              - correction_types
          description: List filters to invert.
      additionalProperties: false
    ClaimAlertsPreview:
      type: object
      properties:
        joining_count:
          type: integer
          minimum: 0
          description: >-
            Selected alerts the request would add to the claim or move into it:
            the changed_count a filter would return.
        joining_by_verdict:
          type: object
          properties:
            pending:
              type: integer
              minimum: 0
            accepted:
              type: integer
              minimum: 0
            dismissed:
              type: integer
              minimum: 0
            skipped:
              type: integer
              minimum: 0
          required:
            - pending
            - accepted
            - dismissed
            - skipped
          description: >-
            The joining alerts by their current verdict. A claim asks only for
            accepted ones; accept_alerts (or verdict accepted) confirms the
            others, false alarms included. The app adds all but the false
            alarms.
        already_in_claim_count:
          type: integer
          minimum: 0
          description: >-
            Selected alerts already in claim_id, which stay in it. Always 0 with
            agreement_id.
        left_out:
          type: object
          properties:
            ineligible_count:
              type: integer
              minimum: 0
              description: >-
                Of another agreement or none, on a deleted invoice, or held by a
                claim (with accept_alerts also a topic) the caller cannot see.
            completed_claim_count:
              type: integer
              minimum: 0
              description: >-
                In a completed claim, which locks its members until it is
                reopened.
            invalidated_count:
              type: integer
              minimum: 0
              description: No longer apply. They keep the claim they have but join none.
            open_claim_count:
              type: integer
              minimum: 0
              description: >-
                In another pending or in-progress claim, where they stay without
                move_from_open_claims. Always 0 with it.
          required:
            - ineligible_count
            - completed_claim_count
            - invalidated_count
            - open_claim_count
          description: >-
            Selected alerts that would not join, each under the first reason
            that applies, in this order. The command leaves them out of a filter
            and refuses alert_ids that name any of them (409).
        joining_alert_ids:
          type: object
          properties:
            pending:
              type: array
              items:
                type: string
                format: uuid
            accepted:
              type: array
              items:
                type: string
                format: uuid
            dismissed:
              type: array
              items:
                type: string
                format: uuid
            skipped:
              type: array
              items:
                type: string
                format: uuid
          required:
            - pending
            - accepted
            - dismissed
            - skipped
          description: >-
            The joining alerts by verdict, in ID order. Send the ones you want
            as alert_ids to add exactly what was previewed.
      required:
        - joining_count
        - joining_by_verdict
        - already_in_claim_count
        - left_out
        - joining_alert_ids
    Error_validation_error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_error
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_invalid_token:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - invalid_token
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
                - token_disabled
                - organization_required
                - insufficient_role
                - mfa_required
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_not_found:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - not_found
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_conflict:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - conflict
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_rate_limit_exceeded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - rate_limit_exceeded
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_internal_error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - internal_error
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
    Error_service_unavailable:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - service_unavailable
            message:
              type: string
            request_id:
              type: string
            description:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - field
                  - message
              maxItems: 20
            workflow_run_id:
              type: string
              format: uuid
            import_id:
              type: string
              format: uuid
            existing_party:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - supplier
                    - recipient
                id:
                  type: string
                  format: uuid
              required:
                - type
                - id
          required:
            - code
            - message
            - request_id
      required:
        - error
  securitySchemes:
    ApiKeyBearer:
      type: http
      scheme: bearer
      description: >-
        Personal API key sent as a bearer token, together with
        X-Organization-Id. The key must have at least the access level the
        endpoint requires (read, write or admin).

````

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