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

# Receber comprovante de apagamento

> Onde a célula entrega o que apagou de um espaço apagado.



## OpenAPI

````yaml openapi/pt/control.json POST /v1/spaces/{space_id}/deletion-receipt
openapi: 3.1.0
info:
  title: API de controle da Niadra
  version: '1'
  description: >-
    Tenants, projetos, fontes, chaves, pessoas, configuração e uso. Nunca recebe
    conteúdo de cliente.
servers:
  - url: https://control.api.niadra.com
security: []
paths:
  /v1/spaces/{space_id}/deletion-receipt:
    post:
      summary: Receber comprovante de apagamento
      description: >-
        Onde uma célula informa o que apagou de um espaço apagado, com o SHA-256
        do JSON canônico do comprovante. O mesmo comprovante enviado de novo é
        aceito; outro comprovante para o mesmo espaço responde 409, e um cujo
        hash não bate responde 422.


        **Autenticação.** Credencial de célula (`X-Niadra-Cell-Token`). Usada
        pelas células da Niadra, não pelo seu código.
      operationId: store_deletion_receipt_v1_spaces__space_id__deletion_receipt_post
      parameters:
        - in: path
          name: space_id
          required: true
          schema:
            format: uuid
            title: Space Id
            type: string
          example: 0192f0a0-3d4e-7f50-8b61-7c8d9e0f1a24
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeletionReceiptIn'
            example:
              cell_id: cell-1
              receipt:
                space_id: 0192f0a0-3d4e-7f50-8b61-7c8d9e0f1a24
                cell_id: cell-1
                db_name: s_0192f0a03d4e7f508b617c8d9e0f1a24
                dropped_at: '2026-09-24T15:02:07+00:00'
                dek_versions_destroyed:
                  - 1
                objects_deleted: 184
                backups_deleted: 7
                secrets_deleted: 2
                instance_snapshot_expiry: '2026-10-29T15:02:07+00:00'
              receipt_hash: 444231a958691293872e18e8de0fad4d0e2de2fec1c66cad1b2e56503f64db37
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletionReceiptOut'
              example:
                space_id: 0192f0a0-3d4e-7f50-8b61-7c8d9e0f1a24
                cell_id: cell-1
                db_name: s_0192f0a03d4e7f508b617c8d9e0f1a24
                dropped_at: '2026-09-24T15:02:07Z'
                dek_versions_destroyed:
                  - 1
                objects_deleted: 184
                backups_deleted: 7
                secrets_deleted: 2
                instance_snapshot_expiry: '2026-10-29T15:02:07Z'
                receipt_hash: >-
                  444231a958691293872e18e8de0fad4d0e2de2fec1c66cad1b2e56503f64db37
                received_at: '2026-09-24T15:02:09Z'
          description: O comprovante guardado.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: O pedido não bate com o contrato.
      security:
        - cellToken: []
components:
  schemas:
    DeletionReceiptIn:
      additionalProperties: false
      properties:
        cell_id:
          pattern: ^[a-z0-9-]{3,63}$
          title: Cell Id
          type: string
          description: A célula que apagou o espaço.
        receipt:
          additionalProperties: true
          description: >-
            O comprovante como a célula o redigiu; `receipt_hash` é o SHA-256 do
            JSON canônico dele.
          title: Receipt
          type: object
        receipt_hash:
          pattern: ^[0-9a-f]{64}$
          title: Receipt Hash
          type: string
          description: >-
            SHA-256 do JSON canônico de `receipt` (chaves em ordem, sem espaços,
            UTF-8), em hexadecimal.
      required:
        - cell_id
        - receipt
        - receipt_hash
      title: DeletionReceiptIn
      type: object
    DeletionReceiptOut:
      additionalProperties: false
      description: >-
        O que a célula apagou, como ela informou. As chaves de dados foram
        destruídas, então qualquer cópia dos dados do espaço que ainda exista
        (as cópias automáticas do próprio servidor de banco, até
        `instance_snapshot_expiry`) não pode mais ser lida.
      properties:
        backups_deleted:
          description: Cópias noturnas do banco do espaço apagadas.
          title: Backups Deleted
          type: integer
        cell_id:
          title: Cell Id
          type: string
          description: A célula que apagou o espaço.
        db_name:
          description: O banco de dados do espaço, removido.
          title: Db Name
          type: string
        dek_versions_destroyed:
          description: As versões das chaves de dados do espaço que foram destruídas.
          items:
            type: integer
          title: Dek Versions Destroyed
          type: array
        dropped_at:
          format: date-time
          title: Dropped At
          type: string
          description: Quando o banco do espaço foi removido.
        instance_snapshot_expiry:
          description: >-
            Quando vence a última cópia automática do servidor de banco que
            ainda pode guardar os dados cifrados do espaço.
          format: date-time
          title: Instance Snapshot Expiry
          type: string
        objects_deleted:
          description: >-
            Objetos guardados apagados: conteúdo bruto, mídia, importações,
            exportações, arquivos de eventos e âncoras de auditoria.
          title: Objects Deleted
          type: integer
        receipt_hash:
          description: SHA-256 do JSON canônico do comprovante, em hexadecimal.
          title: Receipt Hash
          type: string
        received_at:
          format: date-time
          title: Received At
          type: string
          description: Quando o controle guardou o comprovante.
        secrets_deleted:
          description: >-
            Versões de segredo apagadas (credenciais de webhook e de
            exportação).
          title: Secrets Deleted
          type: integer
        space_id:
          format: uuid
          title: Space Id
          type: string
      required:
        - space_id
        - cell_id
        - db_name
        - dropped_at
        - dek_versions_destroyed
        - objects_deleted
        - backups_deleted
        - secrets_deleted
        - instance_snapshot_expiry
        - receipt_hash
        - received_at
      title: DeletionReceiptOut
      type: object
    Problem:
      additionalProperties: false
      description: >-
        Detalhes do problema no formato da RFC 9457; `code` vem do catálogo de
        erros versionado.
      properties:
        code:
          title: Code
          type: string
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Request Id
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        type:
          default: about:blank
          title: Type
          type: string
      required:
        - title
        - status
        - code
      title: Problem
      type: object
  securitySchemes:
    cellToken:
      type: apiKey
      in: header
      name: X-Niadra-Cell-Token

````