Trigger an inbound poll

Dispatches a manual inbound poll for the inbound source config. Accepts an optional X-Idempotency header for 30s dedup; a within-window repeat replays the prior outcome without re-dispatching. Documented status is 202 Accepted; the runtime status is dynamic per outcome (200/409/503).

POST /v1/inbound-source-configs/{id}/trigger-poll

Trigger an inbound poll

cURL

curl --request POST \
  --url https://sta.sandbox.lerian.net/v1/inbound-source-configs/{id}/trigger-poll \
  --header 'Authorization: Bearer <token>'

202

{
  "inboundSourceConfigId": "<string>",
  "outcome": "<string>",
  "replayed": true
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency · string

Optional idempotency key. A repeat with the same key within the 30s dedup window replays the prior outcome without re-dispatching.

Path Parameters

id · string · required

Inbound source config UUID

Example:

"018f3b2a-0c1d-7a2b-9e4f-1a2b3c4d5e6f"

Response

202

application/json

Accepted

inboundSourceConfigId · string · required

outcome · string · required

replayed · boolean · required