agent-sessions
Create Session
Create a new agent session associated with an entity.
POST
Error
Body
application/json
Request schema for creating an agent session.
Response
Successful Response
Response schema for agent session.
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)
Available options:
case, agent_preset, agent_preset_builder, copilot, workflow, approval, external_channel artifacts
(CaseArtifact · object | WorkflowArtifact · object | RunArtifact · object | TableArtifact · object | AgentArtifact · object | FormArtifact · object | AlertArtifact · object | IntegrationArtifact · object | SecretArtifact · object | GenericArtifact · object)[]
Case artifact shown in artifact-capable chat surfaces.
- CaseArtifact
- WorkflowArtifact
- RunArtifact
- TableArtifact
- AgentArtifact
- FormArtifact
- AlertArtifact
- IntegrationArtifact
- SecretArtifact
- GenericArtifact