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

# Lotes guardados

> Os lotes de eventos e de registros de turno que falharam em todas as tentativas de entrar: guardados de lado, cifrados, nunca apagados, do mais antigo para o mais novo, sem o conteúdo.



## OpenAPI

````yaml openapi/pt/cell.json GET /v1/intake/failed
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-2
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/intake/failed:
    get:
      tags:
        - turns
      summary: Lotes guardados
      description: >-
        Os lotes que falharam em todas as tentativas de entrar (`row_failed`):
        guardados de lado, cifrados, nunca apagados, do mais antigo para o mais
        novo. Só o tipo, a fonte e os horários, nunca o conteúdo.


        **Autenticação.** Token de pessoa do Console com o papel `integration`
        (ou admin), ou chave de fonte com o escopo `admin`.
      operationId: failed_intake_v1_intake_failed_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FailedIntakePage'
          description: Resposta de sucesso.
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    FailedIntakePage:
      additionalProperties: false
      properties:
        items:
          description: Do mais antigo para o mais novo, até 500 de cada tipo.
          items:
            $ref: '#/components/schemas/FailedIntake'
          title: Items
          type: array
        kept:
          description: >-
            Todos os lotes guardados, listados ou não; além da lista, `POST
            /v1/intake/failed/retry` sem ids tenta todos de novo.
          minimum: 0
          title: Kept
          type: integer
      required:
        - items
        - kept
      title: FailedIntakePage
      type: object
    FailedIntake:
      additionalProperties: false
      description: >-
        Um lote de dados da empresa que falhou em todas as tentativas de entrar:
        guardado de lado, cifrado como chegou, nunca apagado, até alguém com
        acesso de administração tentá-lo de novo. Que tipo de lote, de qual
        fonte e quando; nunca o conteúdo.
      properties:
        attempts:
          minimum: 0
          title: Attempts
          type: integer
        failed_at:
          format: date-time
          title: Failed At
          type: string
        intake_id:
          format: uuid
          title: Intake Id
          type: string
        kind:
          description: >-
            `events` para `POST /v1/events` e os webhooks, `turns` para `POST
            /v1/turns`.
          enum:
            - events
            - turns
          title: Kind
          type: string
        received_at:
          format: date-time
          title: Received At
          type: string
        source_id:
          format: uuid
          title: Source Id
          type: string
      required:
        - intake_id
        - kind
        - source_id
        - received_at
        - failed_at
        - attempts
      title: FailedIntake
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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