> ## 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 configuración de fuente entrante

> Aprovisiona una configuración de fuente entrante para el tenant autenticado. Cada configuración se protege contra la reserva de descubrimiento de entrada configurada antes de persistir; una violación surge como 422 POLLING_BUDGET_EXCEEDED.



## OpenAPI

````yaml es/openapi/v3-current/sta.yaml post /v1/inbound-source-configs
openapi: 3.0.3
info:
  title: Lerian STA API
  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.
  version: v1.0.0
servers:
  - url: https://sta.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - name: transfers
    description: >-
      Transferencias de archivos STA salientes y entrantes — creación, listado,
      lectura, cancelación, reintento y marcado de procesamiento urgente.
  - name: trust-store
    description: >-
      Ciclo de vida de los certificados X.509 del trust-store del tenant:
      listado, carga, eliminación y resumen de estado.
  - name: credentials
    description: >-
      Gestión de credenciales de BACEN STA: creación, lectura, actualización,
      rotación, revocación y prueba de conectividad.
  - name: inbound-source-configs
    description: >-
      Configuración del sondeo de fuentes entrantes: creación, lectura,
      actualización, eliminación, disparo manual de sondeo y uso de la reserva
      de descubrimiento.
  - name: health
    description: Reporte de salud y disponibilidad del servicio.
paths:
  /v1/inbound-source-configs:
    post:
      tags:
        - inbound-source-configs
      summary: Crear una configuración de fuente entrante
      description: >-
        Aprovisiona una configuración de fuente entrante para el tenant
        autenticado. Cada configuración se protege contra la reserva de
        descubrimiento de entrada configurada antes de persistir; una violación
        surge como 422 POLLING_BUDGET_EXCEEDED.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/http.CreateInboundSourceConfigRequest'
        description: inbound source config payload
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.InboundSourceConfigView'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
components:
  schemas:
    http.CreateInboundSourceConfigRequest:
      properties:
        bacenSystemCode:
          type: string
        bacenSystemFilterCode:
          type: string
        credentialId:
          description: >-
            CredentialID is the UUID of the BACEN credential used to fetch
            inbound

            documents of this source. MANDATORY: every inbound source fetches
            with a

            credential. The uuid tag rejects a malformed value at the boundary
            (400);

            the domain constructor rejects uuid.Nil (422 via the
            reserve/invariant

            path).
          type: string
        displayName:
          type: string
        intervalSeconds:
          maximum: 1800
          minimum: 15
          type: integer
        maxFileSizeBytes:
          minimum: 1
          type: integer
        retentionDays:
          maximum: 3650
          minimum: 1
          type: integer
        sourceProduct:
          type: string
        urgencyEnabled:
          description: >-
            UrgencyEnabled opts this inbound source into urgent inbound
            processing.

            Defaults false. Operator-settable.
          type: boolean
      required:
        - bacenSystemCode
        - credentialId
        - intervalSeconds
        - sourceProduct
      type: object
    http.InboundSourceConfigView:
      properties:
        bacenSystemCode:
          type: string
        bacenSystemFilterCode:
          type: string
        createdAt:
          type: string
        credentialId:
          description: >-
            CredentialID is the UUID string of the BACEN credential bound to
            this

            inbound source (mandatory and always present).
          type: string
        deletedAt:
          type: string
        displayName:
          type: string
        id:
          type: string
        intervalSeconds:
          type: integer
        isEnabled:
          type: boolean
        maxFileSizeBytes:
          type: integer
        retentionDays:
          type: integer
        sourceProduct:
          type: string
        updatedAt:
          type: string
        urgencyEnabled:
          type: boolean
      type: object
  securitySchemes:
    BearerAuth:
      description: 'Bearer token authentication (format: "Bearer {token}")'
      in: header
      name: Authorization
      type: apiKey

````