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

# Disparar un sondeo entrante

> Despacha un sondeo entrante manual para la configuración de fuente entrante. Acepta una cabecera X-Idempotency opcional para deduplicación de 30s; una repetición dentro de la ventana reproduce el resultado anterior sin volver a despachar.



## OpenAPI

````yaml es/openapi/v3-current/sta.yaml post /v1/inbound-source-configs/{id}/trigger-poll
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/{id}/trigger-poll:
    post:
      tags:
        - inbound-source-configs
      summary: Disparar un sondeo entrante
      description: >-
        Despacha un sondeo entrante manual para la configuración de fuente
        entrante. Acepta una cabecera X-Idempotency opcional para deduplicación
        de 30s; una repetición dentro de la ventana reproduce el resultado
        anterior sin volver a despachar.
      parameters:
        - description: Inbound source config UUID
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: Idempotency key (30s dedup window)
          in: header
          name: X-Idempotency
          schema:
            type: string
      responses:
        '200':
          description: Skipped (no-op)
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '202':
          description: Queued
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '409':
          description: Already running
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '503':
          description: Polling manager unavailable
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
components:
  securitySchemes:
    BearerAuth:
      description: 'Bearer token authentication (format: "Bearer {token}")'
      in: header
      name: Authorization
      type: apiKey

````