> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway Status • AI Agent SDK

> GatewayStatus: Read-only snapshot of the gateway's live self-state (Issue #3688).

# GatewayStatus

> Defined in the [**protocols**](../modules/protocols) module.

<Badge color="blue">AI Agent</Badge>

Read-only snapshot of the gateway's live self-state (Issue #3688).

A neutral, serializable shape the agent can reason about and report. All
fields default to empty so a partial/minimal binding is valid and the tool
never dead-ends. The concrete binding populates only the visibility-scoped
facts it can safely expose.

Attributes:
run: Current turn/run status (e.g. "idle", "busy", "queued").
queued: Number of turns queued behind the current one.
active\_sessions: Count of active sessions (visibility-scoped).
sessions\_by\_channel: Active-session counts keyed by channel/platform.
delivery: Delivery-health facts (e.g. outbox\_depth, dlq, dead\_targets).
degraded: Degraded owners as `&#123;"owner": ..., "reason": ...&#125;` entries
(channels/capabilities/routes flagged configured-unavailable).
detail: Optional free-form extra context for the model.

## Properties

<ResponseField name="run" type="str">
  No description available.
</ResponseField>

<ResponseField name="queued" type="int">
  No description available.
</ResponseField>

<ResponseField name="active_sessions" type="int">
  No description available.
</ResponseField>

<ResponseField name="sessions_by_channel" type="Dict[str, int]">
  No description available.
</ResponseField>

<ResponseField name="delivery" type="Dict[str, Any]">
  No description available.
</ResponseField>

<ResponseField name="degraded" type="List">
  No description available.
</ResponseField>

<ResponseField name="detail" type="str">
  No description available.
</ResponseField>

## Methods

<CardGroup cols={2}>
  <Card title="as_dict()" icon="function" href="../functions/GatewayStatus-as_dict">
    Convert to a serializable dictionary.
  </Card>
</CardGroup>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L2721">
  `praisonaiagents/gateway/protocols.py` at line 2721
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Gateway Feature" icon="tower-broadcast" href="/docs/docs/features/gateway" />
</CardGroup>
