Create agent session

Create a new agent session, optionally linked to a persona.

Request body

namestring nullable

Optional name for the session.

persona_idstring uuid nullable

Optional persona ID. The persona defines the agent's prompt, tools, and knowledge bases. When null, uses the default persona.

Successful Response

idstring uuid required

The ID of the created 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.

is_roamingboolean

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

created_atstring date-time required

When the session was created.