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

# Crear una exportación de auditoría

> Encola una exportación de auditoría asíncrona (status GENERATING) para el entity type, el format y la ventana RFC3339 indicados. El rango de fechas está limitado a 365 días; una segunda exportación concurrente para el mismo entity type devuelve 409. El worker generador de exportaciones materializa el objeto.



## OpenAPI

````yaml es/openapi/v3-current/sta.yaml post /v1/audit/exports
openapi: 3.1.0
info:
  description: >-
    API de Lerian STA — el rail del lado del participante que conecta la
    institución con el sistema de intercambio de archivos STA (Sistema de
    Transferência de Arquivos) del Banco Central do Brasil. Cubre las
    transferencias de archivos salientes y entrantes, la gestión de credenciales
    de BACEN, la configuración del sondeo de fuentes entrantes y el trust-store
    del tenant para los certificados de firma de mensajes.
  title: Lerian STA API
  version: v1.0.0
servers:
  - url: https://sta.sandbox.lerian.net
security:
  - BearerAuth: []
paths:
  /v1/audit/exports:
    post:
      tags:
        - audit
      summary: Crear una exportación de auditoría
      description: >-
        Encola una exportación de auditoría asíncrona (status GENERATING) para
        el entity type, el format y la ventana RFC3339 indicados. El rango de
        fechas está limitado a 365 días; una segunda exportación concurrente
        para el mismo entity type devuelve 409. El worker generador de
        exportaciones materializa el objeto.
      operationId: createAuditExport
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExportRequest'
              description: Audit export creation payload
        required: true
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditExportDTO'
          description: Accepted
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      security:
        - BearerAuth: []
components:
  schemas:
    CreateExportRequest:
      additionalProperties: false
      properties:
        entityType:
          description: Audit entity to export (credential_access | transfer_history)
          examples:
            - credential_access
          type: string
        format:
          description: Export format (CSV | JSON_GZIP); defaults to CSV
          examples:
            - CSV
          type: string
        periodFrom:
          description: Inclusive lower bound of the export window (RFC3339)
          examples:
            - '2026-01-01T00:00:00Z'
          format: date-time
          type: string
        periodTo:
          description: Exclusive upper bound of the export window (RFC3339)
          examples:
            - '2026-02-01T00:00:00Z'
          format: date-time
          type: string
      required:
        - entityType
        - periodFrom
        - periodTo
      type: object
    AuditExportDTO:
      additionalProperties: false
      properties:
        completedAt:
          format: date-time
          type: string
        entityType:
          type: string
        failureReason:
          type: string
        format:
          type: string
        id:
          type: string
        periodFrom:
          format: date-time
          type: string
        periodTo:
          format: date-time
          type: string
        recordCount:
          format: int64
          type: integer
        requestedAt:
          format: date-time
          type: string
        requestedBy:
          type: string
        sha256Hash:
          type: string
        sizeBytes:
          format: int64
          type: integer
        status:
          type: string
      required:
        - id
        - status
        - entityType
        - format
        - periodFrom
        - periodTo
        - requestedBy
        - requestedAt
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````