# session

The session interface is used to manage agent session shells and their presentation metadata. New messages are created through the A2A runtime process; this set of interfaces only reads existing messages.

## Choose a task

| Task | Description |
| --- | --- |
| [View session list](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/agent-sessions/list-sessions.html.md) | Query the visible sessions in the workspace. |
| [View session details](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/agent-sessions/get-session.html.md) | Read a visible session’s display metadata and current task association. |
| [Add session](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/agent-sessions/create-session.html.md) | Create a session and display metadata for an active agent without sending messages or starting tasks. |
| [Change session](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/agent-sessions/update-session.html.md) | Change the session title, status, or pinned state; sessions linked to unfinished tasks cannot be archived. |
| [View session messages](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/agents/agent-sessions/list-session-messages.html.md) | Read saved messages in visible sessions. |