OUouterport
Agent

Get agent session

Changed on

Get an agent session.

get/api/v0/agent/sessions/{session_id}

Request

Path parameters

session_idstring uuid required

Response

Successful Response

idstring uuid required

The ID of the session.

persona_idstring uuid nullable

The ID of the persona used by this session. Null means default persona.

namestring nullable required

The name of the session.

statusstring required

The status of the session. Options: 'active', 'completed', 'error'.

message_countinteger required

The number of messages in the session.

is_roamingboolean

True iff this session's persona exposes any fs_* / fs_bash tool and therefore has a workspace directory the agent reads/writes.

section_idstring uuid nullable

The chat history section this session is filed under; null when it is in none.

created_atstring date-time required

When the session was created.

updated_atstring date-time required

When the session was last updated.

Changes