Submits a human resolution for a message in input-required state. The resolution contains field values matching the A2UI spec’s field IDs. On success, the message transitions from input-required to working and the agent resumes execution. Returns 409 Conflict if the message was already resolved.
Authentication: accepts either a JWT (Authorization: Bearer) or a callback_token in the request body. Use JWT when calling from the dashboard or API. Use callback_token when resolving from an external system that received a webhook notification.
curl --request POST \
--url https://api.svantic.com/messages/{message_id}/resolve \
--header 'Content-Type: application/json' \
--data '
{
"resolution": {
"decision": "approve"
},
"callback_token": "<string>"
}
'{
"ok": true,
"message_id": "task-uuid-456",
"new_state": "working"
}Documentation Index
Fetch the complete documentation index at: https://docs.svantic.com/llms.txt
Use this file to discover all available pages before exploring further.
Path Parameters
The message ID to resolve.
Body
Submit a resolution for a pending message. Field keys in resolution must match the A2UI field IDs from the original request. Authenticate with either a JWT (via Authorization header) or a callback_token (in the body).
Key-value pairs matching the A2UI field IDs. For simple approvals: { "decision": "approve" }. For forms: { "username": "...", "password": "..." }.
{ "decision": "approve" }Single-use token from an outbound webhook notification. Provides authentication when the caller doesn't have a JWT. Mutually exclusive with Bearer auth — provide one or the other.
curl --request POST \
--url https://api.svantic.com/messages/{message_id}/resolve \
--header 'Content-Type: application/json' \
--data '
{
"resolution": {
"decision": "approve"
},
"callback_token": "<string>"
}
'{
"ok": true,
"message_id": "task-uuid-456",
"new_state": "working"
}