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

# Retrieve Session • AI Agent SDK

> retrieve_session: Retrieve the current managed session's metadata and usage.

# retrieve\_session

<div className="flex items-center gap-2">
  <Badge color="purple">Method</Badge>
</div>

> This is a method of the [**ManagedBackendProtocol**](../classes/ManagedBackendProtocol) class in the [**protocols**](../modules/protocols) module.

Retrieve the current managed session's metadata and usage.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def retrieve_session() -> Dict[str, Any]
```

### Returns

<ResponseField name="Returns" type="Dict[str, Any]">
  Dict with session info (id, status, usage, etc.).
</ResponseField>

## Source

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

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Session Management" icon="clock" href="/docs/docs/concepts/session-management" />

  <Card title="Sessions Feature" icon="folder" href="/docs/docs/features/sessions" />

  <Card title="Session Persistence" icon="database" href="/docs/docs/features/session-persistence" />
</CardGroup>