Update Agent Session

Changed on

Replace a session plan or external links using its current version.

patch/api/v4/{workspace-slug}/agent-sessions/{agent-session-id}

Request

  • Base URL: https://api.app.shortcut.com
  • URL: https://api.app.shortcut.com/api/v4/{workspace-slug}/agent-sessions/{agent-session-id}
  • Auth: HTTP bearer

Path parameters

workspace-slugstring required

The slug for the Workspace.

agent-session-idstring uuid required

The ID of the Agent Session.

Request body

versioninteger required

The current session version. The update fails with 409 if it has changed.

Response

Resource

acknowledged_atstring date-time nullable required
agent_member_idstring uuid required
closed_reasonstring nullable required
created_atstring date-time required
created_bystring uuid required
entity_idinteger required
entity_type'story' | 'epic' required
first_delivery_atstring date-time nullable required
idstring uuid required
installation_idstring uuid required
last_agent_activity_atstring date-time nullable required
last_delivery_errorstring nullable required
last_delivery_failed_atstring date-time nullable required
status'awaiting_input' | 'complete' | 'error' | 'stale' | 'active' | 'pending' required
stop_requested_atstring date-time nullable required
thread_comment_idinteger nullable required
turninteger required
updated_atstring date-time required
versioninteger required
workspace_idstring uuid required

Changes