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

# Archive events

> Archives the latest version of each event identified by the supplied `idempotencyKeys` by inserting an archive tombstone (version = N+1, archived_at = now()). Event rows are not deleted; the tombstone marks each key as archived. Idempotent: non-existent keys and already-archived keys are silently skipped. The response `archivedIdempotencyKeys` lists only the keys for which a new tombstone was written.



## OpenAPI

````yaml /api-reference/openapi.yaml put /v1/events/archive
openapi: 3.1.0
info:
  title: API Reference
  version: '1.0'
  description: Aira API Reference
  x-logo:
    url: https://static.useaira.com/images/airalogo.svg
    backgroundColor: '#FFFFFF'
    altText: Aira Logo
servers:
  - url: https://api.useaira.com
    description: API base URL
security:
  - ApiKey: []
paths:
  /v1/events/archive:
    put:
      tags:
        - Events
      summary: Archive events
      description: >-
        Archives the latest version of each event identified by the supplied
        `idempotencyKeys` by inserting an archive tombstone (version = N+1,
        archived_at = now()). Event rows are not deleted; the tombstone marks
        each key as archived. Idempotent: non-existent keys and already-archived
        keys are silently skipped. The response `archivedIdempotencyKeys` lists
        only the keys for which a new tombstone was written.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                idempotencyKeys:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  maxItems: 10000
                  uniqueItems: true
              required:
                - idempotencyKeys
              additionalProperties: false
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  archivedIdempotencyKeys:
                    type: array
                    items:
                      type: string
                required:
                  - archivedIdempotencyKeys
                additionalProperties: false
        '400':
          description: Error object returned to the client.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: A human-readable description of the error
                  code:
                    type: string
                    description: A unique identifier for the type of error
                  details:
                    oneOf:
                      - type: object
                        additionalProperties: true
                      - type: array
                    description: >-
                      Additional context about the error, such as invalid fields
                      or constraints. Each endpoint may include specific error
                      details in their documentation
                  causations:
                    type: array
                    description: >-
                      Optional array of error objects following the same
                      structure as the parent error. Only present when there's a
                      meaningful chain of related errors to expose
                    items:
                      type: object
                      properties:
                        message:
                          type: string
                          description: >-
                            A human-readable description of the underlying error
                            cause
                        code:
                          type: string
                          description: A unique identifier for the type of underlying error
                        details:
                          type: object
                          additionalProperties: true
                          description: Additional context about the underlying error
                      required:
                        - message
                        - code
                      additionalProperties: false
                required:
                  - code
                  - message
                additionalProperties: false
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      description: API Key Authentication.
      name: X-API-KEY
      in: header

````