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

# Kept batches

> The batches of events and turn records that failed every attempt to be taken in: kept aside, sealed, never deleted, oldest first, without their content.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/intake/failed
openapi: 3.1.0
info:
  title: Niadra data API
  version: '1'
  description: >-
    Writing, context, history, objects, identity, privacy and governance of one
    space. Every space has a stable address, with the space and the region in
    its name.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: The space, which comes in the source key.
      region:
        default: us-east-2
        description: The region of the space, which also comes in the key.
security: []
paths:
  /v1/intake/failed:
    get:
      tags:
        - turns
      summary: Kept batches
      description: >-
        The batches that failed every attempt to be taken in (`row_failed`):
        kept aside, sealed, never

        deleted, oldest first. Kind, source and times only, never their content.


        **Authentication.** Console person token with the `integration` role (or
        admin), or a source key with the `admin` scope.
      operationId: failed_intake_v1_intake_failed_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FailedIntakePage'
          description: Successful Response
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    FailedIntakePage:
      additionalProperties: false
      properties:
        items:
          description: Oldest first, up to 500 of each kind.
          items:
            $ref: '#/components/schemas/FailedIntake'
          title: Items
          type: array
        kept:
          description: >-
            Every batch kept aside, listed or not; past the listing, `POST
            /v1/intake/failed/retry` with no ids retries all of them.
          minimum: 0
          title: Kept
          type: integer
      required:
        - items
        - kept
      title: FailedIntakePage
      type: object
    FailedIntake:
      additionalProperties: false
      description: >-
        A batch of the company's data that failed every attempt to be taken in:
        kept aside, sealed as it

        came, never deleted, until an admin retries it. What kind of batch, from
        which source and when; never

        its content.
      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` for `POST /v1/events` and the webhooks, `turns` for `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.