session_update

TOOLtools/call

Link one of this agent's sessions to a project task, move it to another task, or clear the link with projectTaskId null. Linking needs read:projects and a task you can read.

Scopes

write:agent_sessions

Also needs read:projects when projectTaskId names a task.

Inputs

sessionIdstringRequired: Session ID
projectTaskIdstring | nullRequired: taskId of the project task (from task_list or task_get), or null to clear.
idempotencyKeystringRequired: Unique retry key

Returns

The updated session. A call returns content[0].text with the JSON result and structuredContent.result with the same value.

Listed when

The key has agent access.