> ## 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.

# Reread an invoice or letter with a corrected interpretation

> Admits a reread of the current source documents as an invoice or a reminder. A successful extraction atomically replaces the same record; no second invoice is created. The current record is unchanged if extraction fails, another duplicate is found, or its revision, sources, access or financial dependencies change. Read the returned import for progress. A previously processed record uses no additional processing capacity. An optional Idempotency-Key returns the same import on replay.



## OpenAPI

````yaml /openapi.json post /v1/invoices/{id}/classification
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/invoices/{id}/classification:
    post:
      tags:
        - Invoices
      summary: Reread an invoice or letter with a corrected interpretation
      description: >-
        Admits a reread of the current source documents as an invoice or a
        reminder. A successful extraction atomically replaces the same record;
        no second invoice is created. The current record is unchanged if
        extraction fails, another duplicate is found, or its revision, sources,
        access or financial dependencies change. Read the returned import for
        progress. A previously processed record uses no additional processing
        capacity. An optional Idempotency-Key returns the same import on replay.
      operationId: classifyInvoice
      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.
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 200
            pattern: ^[\x21-\x7e]+$
          description: >-
            Optional protection for safely retrying a request after a timeout or
            lost response. Choose a unique value (for example, a UUID) for each
            action and reuse it with the same input when retrying. Omit it for a
            normal request.
        - schema:
            type: string
            format: uuid
          required: true
          name: id
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                read_as:
                  type: string
                  enum:
                    - invoice
                    - reminder
                expected_updated_at:
                  type: string
                  format: date-time
              required:
                - read_as
                - expected_updated_at
              additionalProperties: false
      responses:
        '200':
          description: 'Idempotent replay: the same import in its current state.'
          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.
            Location:
              schema:
                type: string
              required: false
              description: Relative URL of the created or accepted resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvoiceImport'
        '202':
          description: 'The new import: queued, or already completed as a duplicate.'
          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.
            Location:
              schema:
                type: string
              required: false
              description: Relative URL of the created or accepted resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvoiceImport'
        '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, or invoice_processing_capacity_exhausted: the
            organization has no invoice processing capacity left. Nothing was
            imported.
          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, or invoice_processing_capacity_exhausted: the
                    organization has no invoice processing capacity left.
                    Nothing was imported.
                  request_id: req_example
              schema:
                $ref: >-
                  #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required_invoice_processing_capacity_exhausted
        '404':
          description: The resource does not exist in the current organization.
          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 resource does not exist in the current organization.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_not_found'
        '409':
          description: >-
            conflict: the Idempotency-Key was used with a different request, the
            import cannot be changed in its current state, or a document already
            belongs to another invoice. source_unavailable: an uploaded file is
            missing or has changed.
          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.
            Location:
              schema:
                type: string
              required: false
              description: Relative URL of the created or accepted resource.
          content:
            application/json:
              example:
                error:
                  code: conflict
                  message: >-
                    conflict: the Idempotency-Key was used with a different
                    request, the import cannot be changed in its current state,
                    or a document already belongs to another invoice.
                    source_unavailable: an uploaded file is missing or has
                    changed.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_conflict_source_unavailable'
        '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: >-
            The service is temporarily unavailable. If error.import_id is
            present, the import exists: read its status 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.
            Location:
              schema:
                type: string
              required: false
              description: Relative URL of the created or accepted resource.
            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: >-
                    The service is temporarily unavailable. If error.import_id
                    is present, the import exists: read its status before
                    retrying.
                  request_id: req_example
              schema:
                $ref: '#/components/schemas/Error_service_unavailable'
      security:
        - ApiKeyBearer: []
components:
  schemas:
    InvoiceImport:
      allOf:
        - $ref: '#/components/schemas/InvoiceImportSummary'
        - type: object
          properties:
            sources:
              type: array
              items:
                type: object
                properties:
                  document:
                    $ref: '#/components/schemas/Document'
                  role:
                    type: string
                    enum:
                      - primary
                      - attachment
                  position:
                    type: integer
                required:
                  - document
                  - role
                  - position
            sources_next_cursor:
              type:
                - string
                - 'null'
            evidence:
              type: array
              items:
                type: object
                properties:
                  stage:
                    type: string
                    enum:
                      - inspection
                      - header
                      - lines
                      - xml
                      - claims
                  succeeded:
                    type: boolean
                  created_at:
                    type: string
                    format: date-time
                  confidence_level:
                    type:
                      - string
                      - 'null'
                    enum:
                      - high
                      - mid
                      - low
                      - null
                  confidence_reason:
                    type:
                      - string
                      - 'null'
                    maxLength: 2000
                required:
                  - stage
                  - succeeded
                  - created_at
                  - confidence_level
                  - confidence_reason
              maxItems: 5
              description: >-
                The latest result of each extraction step, for diagnostics. More
                steps may be added.
            skipped_attachments:
              type: array
              items:
                type: object
                properties:
                  reason:
                    type: string
                    enum:
                      - too_large
                      - total_too_large
                      - too_many
                      - unreadable
                      - too_small
                    description: >-
                      too_large: over 100 MiB, the limit for a file embedded in
                      an XML file. total_too_large: the attachments of one
                      import may total 100 MiB, not counting the primary
                      document. too_many: more than 25 embedded files.
                      unreadable: not valid base64. too_small: under 100 bytes.
                  media_type:
                    type:
                      - string
                      - 'null'
                    maxLength: 255
                    description: The type the XML declares for the file.
                  file_size:
                    type:
                      - integer
                      - 'null'
                    minimum: 0
                    description: Size in bytes, when it could be determined.
                required:
                  - reason
                  - media_type
                  - file_size
              maxItems: 100
              description: >-
                Files embedded in an XML source that were not unpacked into
                documents of their own. They are still inside the XML, which
                stays downloadable. Empty when everything was unpacked.
          required:
            - sources
            - sources_next_cursor
            - evidence
            - skipped_attachments
    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_invoice_processing_capacity_exhausted:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
                - token_disabled
                - organization_required
                - insufficient_role
                - mfa_required
                - invoice_processing_capacity_exhausted
            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_source_unavailable:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - conflict
                - source_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
    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
    InvoiceImportSummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - failed
            - cancelled
        origin:
          type: string
          enum:
            - upload
            - api
            - email
            - integration
            - peppol
          description: How the invoice was submitted.
        company_id:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            The company it was received for: the upload's company_id, a
            company's own email address or its Peppol receiver. Null when the
            source names none and the invoice is placed by the recipient it
            names.
        supersedes_invoice:
          type: boolean
          description: >-
            True when this import replaces an existing invoice from the same
            source.
        deleted_at:
          type:
            - string
            - 'null'
          format: date-time
        primary_document:
          anyOf:
            - $ref: '#/components/schemas/Document'
            - type: 'null'
        source_count:
          type: integer
          minimum: 0
        attachment_count:
          type: integer
          minimum: 0
        retryable:
          type: boolean
          description: Whether the import can be retried.
        provenance:
          type: object
          properties:
            uploader:
              type:
                - object
                - 'null'
              properties:
                user_id:
                  type: string
                name:
                  type:
                    - string
                    - 'null'
                deleted:
                  type: boolean
                  description: >-
                    The uploader account was deleted. The name is kept, or null
                    once the account is anonymised.
              required:
                - user_id
                - name
                - deleted
            api_key:
              type:
                - object
                - 'null'
              properties:
                name:
                  type: string
              required:
                - name
            email:
              type:
                - object
                - 'null'
              properties:
                sender:
                  type:
                    - string
                    - 'null'
                name:
                  type:
                    - string
                    - 'null'
                sender_verified:
                  type:
                    - boolean
                    - 'null'
                  description: >-
                    Whether the sending domain signed the email (DKIM). False
                    means the sender is only what the From header claims; null
                    for email received before the check.
              required:
                - sender
                - name
                - sender_verified
            integration:
              type:
                - object
                - 'null'
              properties:
                id:
                  type: string
                  format: uuid
                name:
                  type: string
                type:
                  type: string
                deleted:
                  type: boolean
                  description: The integration was deleted after it delivered the file.
              required:
                - id
                - name
                - type
                - deleted
          required:
            - uploader
            - api_key
            - email
            - integration
        classification_reason:
          type:
            - string
            - 'null'
        outcome:
          type:
            - string
            - 'null'
          enum:
            - imported
            - duplicate
            - not_invoice
            - reminder
            - null
        invoice_id:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            The current result record, when visible. Historical reminder
            receipts resolve it through their retained primary document; the
            recorded outcome is unchanged.
        invoice_deleted:
          type: boolean
          description: >-
            True when the invoice in `invoice_id` is deleted, such as one whose
            file arrived again as a `duplicate`. It can be restored.
        workflow_run_id:
          type: string
          format: uuid
        workflow_run_item_id:
          type: string
          format: uuid
        failure:
          type:
            - object
            - 'null'
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - status
        - origin
        - company_id
        - supersedes_invoice
        - deleted_at
        - primary_document
        - source_count
        - attachment_count
        - retryable
        - provenance
        - classification_reason
        - outcome
        - invoice_id
        - invoice_deleted
        - workflow_run_id
        - workflow_run_item_id
        - failure
        - created_at
        - updated_at
    Document:
      type: object
      properties:
        id:
          type: string
          format: uuid
        file_name:
          type: string
        mime_type:
          type:
            - string
            - 'null'
        file_size:
          type:
            - integer
            - 'null'
        page_count:
          type:
            - integer
            - 'null'
        md5_checksum:
          type:
            - string
            - 'null'
          description: Base64 MD5 of the file. Null until the upload has been verified.
        properties:
          oneOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - workbook
                sheets:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      hidden:
                        type: boolean
                      row_count:
                        type: integer
                        minimum: 0
                    required:
                      - name
                      - hidden
                      - row_count
              required:
                - kind
                - sheets
            - type: 'null'
          description: >-
            What the file contains, keyed by `kind`. For `workbook` (XLSX): each
            worksheet in order, with its `name`, whether it is `hidden`, and
            `row_count` (rows with at least one non-empty cell). Null when not
            available for this file.
        created_at:
          type: string
          format: date-time
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
        version:
          type:
            - integer
            - 'null'
        previous_version_id:
          type:
            - string
            - 'null'
          format: uuid
      required:
        - id
        - file_name
        - mime_type
        - file_size
        - page_count
        - md5_checksum
        - properties
        - created_at
        - updated_at
        - version
        - previous_version_id
  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.