Messages

Resolve Task

Resolves a pending task in a chat. Blocks until the model response is complete and returns the resulting message.

post/chats/{chatId}/messages/resolve

Path parameters

chatIdstring required

The unique identifier of the chat.

Request body

Response

A single message in a chat.

idstring required

Unique message identifier.

chatIdstring required

ID of the chat this message belongs to.

role'user' | 'assistant' required

Who produced this message.

createdAtstring date-time required

ISO timestamp when the message was created.

updatedAtstring date-time required

ISO timestamp when the message was last updated.

contentstring required

The trailing prose of the message — the agent’s closing summary, or the user’s message text. Empty string when there is no closing prose.

finishReason'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other' nullable required

The reason why message generation finished, including standard completion reasons and error states.

restorableboolean required

True when this is an assistant message that produced restorable code and is not the currently active code.

authorIdstring nullable required

ID of the user who authored a user message; null for assistant messages.

Changes

Changed in 3 of the 34 revisions of this API.10

    • added the new optional request property task/oneOf[subschema #4]/permissions/items/toolDisplayName (media type: application/json)

      new-optional-request-property

    • added the new optional request property task/oneOf[subschema #4]/permissions/items/toolDisplayName (media type: application/x-www-form-urlencoded)

      new-optional-request-property

    • added the new optional request property task/oneOf[subschema #4]/permissions/items/toolDisplayName (media type: multipart/form-data)

      new-optional-request-property

    • added the optional property parts/items/oneOf[subschema #7]/suggestedPermissions/items/toolDisplayName to the response with the 200 status

      response-optional-property-added

    • added the optional property parts/items/oneOf[subschema #7]/toolDisplayName to the response with the 200 status

      response-optional-property-added

    • added subschema #5 to the task request property oneOf list (media type: application/json)

      request-property-one-of-added

    • added subschema #5 to the task request property oneOf list (media type: application/x-www-form-urlencoded)

      request-property-one-of-added

    • added subschema #5 to the task request property oneOf list (media type: multipart/form-data)

      request-property-one-of-added

    • added subschema #4 to the parts/items/oneOf[subschema #8]/data response property anyOf list for the response status 200

      response-property-any-of-added

    • endpoint added

      endpoint-added

    This revision also has 50 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog