Skip to main content
GET
Get volatile event-source status

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

eventSourceId
string<uuid>
required

Stable event-source identifier.

Response

Operational status for one event source without secret material.

Operational status for one event source without secret material.

eventSourceId
string<uuid>
required

Stable identifier for the event source.

health
enum<string>
required

Current source availability. For managed IMAP, healthy means the recent mailbox check succeeded; connecting means an attempt is pending or in progress; connection_failed or credentials_unavailable retries automatically; recovery_required needs a new source; listener_unavailable means no recent attempt. Other sources report receipt history, not current provider reachability; setup_required means installation permissions need approval.

Available options:
never_received,
healthy,
paused,
connection_unavailable,
setup_required,
connecting,
connection_failed,
credentials_unavailable,
recovery_required,
listener_unavailable
lastDelivery
object | null
required

Most recent verified delivery, or null when none has arrived.

triggerCount
integer<int64>
required

Enabled triggers bound to this event source, including triggers on paused automations. The per-source trigger limit applies to this count.

Required range: 0 <= x <= 9007199254740991