Update a tool task status

Updates the status, message, and response of a tool task. Used by frontend applications to report tool execution results or status changes.

This endpoint only updates the tool task and returns the updated task as JSON. It does not trigger AI responses.

To update a tool task AND trigger AI continuation, use the POST /chats/{discussionId}/tool-tasks/{toolTaskId} endpoint instead.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier of the discussion

string
required

The unique identifier of the tool task

Body Params
string
enum
required

New state for the tool task

Allowed:
string

Optional status message

string

Tool execution response (required when state is completed)

Headers
string
required

JWT authentication token

Responses

400

Bad request - validation failed or error updating tool task

401

Unauthorized - invalid or missing authentication

404

Discussion or tool task not found

500

Internal server error

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json