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

# Informe de revisión

> Problemas encontrados y arreglos aplicados.



## OpenAPI

````yaml /openapi.json get /documents/{document_id}/report
openapi: 3.1.0
info:
  title: Doconda API
  version: 0.1.0
  license:
    name: Proprietary
    url: https://doconda.com/terms
  description: >-
    Create, review and edit Word, PowerPoint, Excel and PDF documents for AI
    agents. `POST /documents` works like an LLM API: direct (default), `stream:
    true` (SSE) or `background: true`.

    Errors follow RFC 9457 (application/problem+json). `POST /documents` accepts
    `Idempotency-Key`.
servers:
  - url: https://api.eu.doconda.com/v1
    description: EU (API keys `ak_eu_…`)
  - url: https://api.us.doconda.com/v1
    description: US (not deployed yet)
security:
  - apiKey: []
tags:
  - name: Documents
    description: Create, review and edit documents.
  - name: Files
    description: Your own files, to use as a source or to review/edit.
  - name: Webhooks
    description: Be notified when a document is ready.
  - name: Dashboard
    description: >-
      Used by the Doconda dashboard with a signed-in user. Not available with
      API keys.
paths:
  /documents/{document_id}/report:
    get:
      tags:
        - Documents
      summary: 'Review report: problems found and fixes applied'
      operationId: getDocumentReport
      parameters:
        - name: document_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Report.
          content:
            application/json:
              schema:
                type: object
                properties:
                  document_id:
                    type: string
                    pattern: ^doc_[0-9A-HJKMNP-TV-Z]{26}$
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          examples:
                            - table.overflow_width
                            - money.words_mismatch
                        severity:
                          type: string
                          enum:
                            - error
                            - warning
                            - info
                        category:
                          type: string
                          enum:
                            - structural
                            - semantic
                            - visual
                        message:
                          type: string
                        fixable:
                          type: boolean
                        location:
                          type: object
                          properties:
                            pages:
                              description: >-
                                Pages (Word, PDF) or slides (PowerPoint) where
                                it is, starting at 1.
                              type: array
                              items:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                            sheet:
                              description: 'Excel: the sheet.'
                              type: string
                            cells:
                              description: >-
                                Excel: the cells or ranges (B3, A2:B2) inside
                                `sheet`.
                              type: array
                              items:
                                type: string
                      required:
                        - code
                        - severity
                        - category
                        - message
                        - fixable
                        - location
                    description: What is left after repairs.
                  ledger:
                    type: array
                    items:
                      type: object
                      properties:
                        iteration:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        fix:
                          type: string
                          description: What was tried, in plain words.
                        issue_code:
                          type: string
                        outcome:
                          type: string
                          enum:
                            - applied
                            - rejected
                        issues_before:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        issues_after:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        reason:
                          description: Why it was rejected.
                          type: string
                      required:
                        - iteration
                        - fix
                        - issue_code
                        - outcome
                        - issues_before
                        - issues_after
                    description: 'Every repair attempted: applied or rejected, and why.'
                  validation_summary:
                    type: object
                    properties:
                      errors:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      warnings:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      info:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                    required:
                      - errors
                      - warnings
                      - info
                  repair_summary:
                    type: object
                    properties:
                      iterations:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      applied:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      rejected:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                    required:
                      - iterations
                      - applied
                      - rejected
                  key_data:
                    description: >-
                      Key data found in the document (amounts, dates, tax ids,
                      IBANs), with their role.
                    type: array
                    items:
                      type: object
                      properties:
                        value:
                          type: string
                        kind:
                          type: string
                          description: '`amount`, `date`, `tax_id`, `iban`…'
                        role:
                          description: >-
                            Its role: `main_amount`, `signature_date`,
                            `due_date`…
                          type:
                            - string
                            - 'null'
                        context:
                          type: string
                      required:
                        - value
                        - kind
                        - role
                        - context
                  edits:
                    description: >-
                      Only for `edit`: every change asked for, applied or not,
                      with the text before and after.
                    type: array
                    items:
                      type: object
                      properties:
                        op:
                          type: string
                        block:
                          type: string
                        target:
                          type: string
                        outcome:
                          type: string
                          enum:
                            - applied
                            - rejected
                        before:
                          type: string
                        after:
                          type: string
                        reason:
                          type: string
                      required:
                        - op
                        - outcome
                  changes:
                    description: >-
                      Edits by the agent or by hand (a saved version): the
                      paragraphs, cells or slide texts that were added, changed
                      or removed.
                    type: array
                    items:
                      type: object
                      properties:
                        change:
                          type: string
                          enum:
                            - added
                            - changed
                            - removed
                        before:
                          type: array
                          items:
                            type: string
                        after:
                          type: array
                          items:
                            type: string
                      required:
                        - change
                        - before
                        - after
                  sanitized:
                    description: >-
                      Only for `review`/`edit`: what we neutralised in your file
                      before opening it.
                    type: object
                    properties:
                      removed:
                        type: array
                        items:
                          type: string
                        examples:
                          - - imagen enlazada
                            - plantilla adjunta
                    required:
                      - removed
                required:
                  - document_id
                  - issues
                  - ledger
                  - validation_summary
                  - repair_summary
        '401':
          description: >-
            unauthorized (missing, unknown or revoked key; expired session) or
            region_mismatch.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  code:
                    type: string
                    description: >-
                      Stable machine code, e.g. input_invalid,
                      insufficient_balance.
                  request_id:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                      required:
                        - path
                        - message
                required:
                  - type
                  - title
                  - status
                  - code
                  - request_id
        '404':
          description: not_found
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  code:
                    type: string
                    description: >-
                      Stable machine code, e.g. input_invalid,
                      insufficient_balance.
                  request_id:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                      required:
                        - path
                        - message
                required:
                  - type
                  - title
                  - status
                  - code
                  - request_id
        '409':
          description: 'report_not_ready: available once the document has finished.'
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  code:
                    type: string
                    description: >-
                      Stable machine code, e.g. input_invalid,
                      insufficient_balance.
                  request_id:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                      required:
                        - path
                        - message
                required:
                  - type
                  - title
                  - status
                  - code
                  - request_id
      security:
        - apiKey: []
        - session: []
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        `Authorization: Bearer ak_eu_…`. The prefix is the project's region and
        must match the server (api.eu / api.us).
    session:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Dashboard only: the Cognito ID token of the signed-in user.'

````

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