Agent

Create agent session

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

post/api/v0/agent/sessions

Request

Base URL
https://api.outerport.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/agent/sessions/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Nov 11, 2026f9dcfeb78d3d Revision changes
- info
  added the optional property to the response with the status
Sep 25, 2026fcd15f6d35b4 Revision changes
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status