mcp

Mcp Agent Session Start

Open an observability session. Send X-MCP-Session-Id: <session_id> on every subsequent MCP call so backend auto-capture attaches mutations to this thread. Idempotent on a running (project, session_ref).

post/v1/mcp/projects/{project_id}/agent/sessions

Request

  • Base URL: https://api.sonenta.dev
  • URL: https://api.sonenta.dev/v1/mcp/projects/{project_id}/agent/sessions
  • Auth: none declared

Path parameters

project_idstring required

Request body

agentstring required

Stable agent label shown in the dashboard

titlestring nullable
session_refstring nullable

Client idempotency key; defaults to the X-MCP-Session-Id header

metadataobject nullable
agent_typestring nullable
agent_versionstring nullable

Response

Successful Response

vinteger
session_idstring required
statusstring required
started_atstring date-time required
session_headerstring
channelstring required

Changes

No recorded changes to this operation across all 1 revision of this API.