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

# Choose the supplier of an import

> A person names the supplier of an import that failed as creditor_unknown: the invoice, or the reminder or collection notice, printed its supplier without a usable organization or VAT number and nothing else identified it, and Watchdog never creates a supplier from a name alone. The import is read again as a new attempt and published with this supplier. Poll the import as after createInvoiceImport.



## OpenAPI

````yaml /openapi.json post /v1/invoices/imports/{id}/letter-creditor
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/imports/{id}/letter-creditor:
    post:
      tags:
        - Invoice imports
        - Invoices
      summary: Choose the supplier of an import
      description: >-
        A person names the supplier of an import that failed as
        creditor_unknown: the invoice, or the reminder or collection notice,
        printed its supplier without a usable organization or VAT number and
        nothing else identified it, and Watchdog never creates a supplier from a
        name alone. The import is read again as a new attempt and published with
        this supplier. Poll the import as after createInvoiceImport.
      operationId: chooseInvoiceImportLetterCreditor
      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:
              $ref: '#/components/schemas/ChooseLetterCreditor'
      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 import, queued again.
          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 import is not a letter waiting for its creditor, or
            the Idempotency-Key was used with a different request.
            source_unavailable: a source 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 import is not a letter waiting for its
                    creditor, or the Idempotency-Key was used with a different
                    request. source_unavailable: a source 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:
    ChooseLetterCreditor:
      type: object
      properties:
        supplier_id:
          type: string
          format: uuid
          description: An existing supplier (listSuppliers).
      required:
        - supplier_id
      additionalProperties: false
    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.