OUouterport
Agent

File agent session under a section

Changed on

File the session under one of the user's chat history sections, moving it out of any other, or under none when section_id is null. The session's updated_at does not change.

put/api/v0/agent/sessions/{session_id}/section

Request

Path parameters

session_idstring uuid required

Request body

section_idstring uuid nullable required

The section to file the session under; null files it under none.

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