Skip to main content
POST
/
messages
/
{message_id}
/
resolve
Resolve a pending message
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"
}

Path Parameters

​
message_id
string
required

The message ID to resolve.

Body

application/json

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).

​
resolution
object
required

Key-value pairs matching the A2UI field IDs. For simple approvals: { "decision": "approve" }. For forms: { "username": "...", "password": "..." }.

Example:
{ "decision": "approve" }
​
callback_token
string

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.

Response

Resolution accepted — agent will resume.

Resolution result.

​
ok
boolean

Whether the resolution was accepted.

​
message_id
string

The message that was resolved.

​
new_state
enum<string>

The message's state after resolution.

Available options:
working,
completed,
failed