TRtracecat
agent-sessions

Update Session

Update session properties.

patch/workspaces/{workspace_id}/agent/sessions/{session_id}

Request

  • Base URL
    https://platform.tracecat.com/api
  • Auth
    • API key in cookie fastapiusersauth
    • or HTTP bearer

Path parameters

session_idstring uuid required
workspace_idstring uuid required

Request body

titlestring nullable

Session title

toolsstring[] nullable

Extra tools added to this session alongside entity defaults

mcp_integrationsstring[] nullable

MCP integration IDs attached to this session

agent_preset_idstring uuid nullable

Agent preset to use for this session

agent_preset_version_idstring uuid nullable

Pinned preset version to use for this session. Set null to follow the preset's current version.

backend_idstring nullable

Immutable agent backend identifier

harness_typestring nullable

Immutable execution harness

Response

Successful Response

idstring uuid required
workspace_idstring uuid required
titlestring required
created_bystring uuid nullable required
is_readonlyboolean

Whether the requesting actor can modify this session

entity_type'case' | 'agent_preset' | 'agent_preset_builder' | 'copilot' | 'workflow' | 'approval' | 'external_channel' required

The type of entity associated with an agent session.

Determines the context and behavior of the session:

  • CASE: Chat attached to a Case entity for investigation
  • AGENT_PRESET: Live chat testing a preset configuration
  • AGENT_PRESET_BUILDER: Builder chat for editing/configuring a preset
  • WORKSPACE_CHAT: Workspace-level chat assistant (wire value: copilot)
  • WORKFLOW: Workflow-initiated agent run (from action)
  • APPROVAL: Inbox approval continuation (hidden from main chat list)
  • EXTERNAL_CHANNEL: External channel session (e.g. Slack thread)
entity_idstring uuid required
channel_contextobject nullable required
toolsstring[] nullable required
mcp_integrationsstring[] nullable required
agent_preset_idstring uuid nullable required
agent_preset_version_idstring uuid nullable required
backend_idstring
harness_typestring nullable required
last_errorstring nullable
last_stream_idstring nullable
parent_session_idstring uuid nullable
spawned_by_session_idstring uuid nullable
forked_from_session_idstring uuid nullable
created_atstring date-time required
updated_atstring date-time required

Changes

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