> ## 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 un header X-Idempotency opcional para la deduplicación de 30s; una repetición dentro de la ventana reproduce el resultado anterior sin volver a despachar. El status documentado es 202 Accepted; el status en runtime es dinámico según el resultado (200/409/503).



## OpenAPI

````yaml es/openapi/v3-current/sta.yaml post /v1/inbound-source-configs/{id}/trigger-poll
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/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 un header X-Idempotency opcional para la deduplicación
        de 30s; una repetición dentro de la ventana reproduce el resultado
        anterior sin volver a despachar. El status documentado es 202 Accepted;
        el status en runtime es dinámico según el resultado (200/409/503).
      operationId: triggerInboundSourceConfigPoll
      parameters:
        - description: Inbound source config UUID
          in: path
          name: id
          required: true
          schema:
            description: Inbound source config UUID
            examples:
              - 018f3b2a-0c1d-7a2b-9e4f-1a2b3c4d5e6f
            type: string
        - description: >-
            Optional idempotency key. A repeat with the same key within the 30s
            dedup window replays the prior outcome without re-dispatching.
          in: header
          name: X-Idempotency
          schema:
            description: >-
              Optional idempotency key. A repeat with the same key within the
              30s dedup window replays the prior outcome without re-dispatching.
            type: string
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerPollView'
          description: Accepted
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      security:
        - BearerAuth: []
components:
  schemas:
    TriggerPollView:
      additionalProperties: false
      properties:
        inboundSourceConfigId:
          type: string
        outcome:
          type: string
        replayed:
          type: boolean
      required:
        - inboundSourceConfigId
        - outcome
        - replayed
      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

````