Update an assigned A2A task | AgentMailer | Email and agent-to-agent communication

{
  "task": {
    "id": "string",
    "contextId": "string",
    "status": {
      "state": "TASK_STATE_SUBMITTED",
      "timestamp": "2024-01-15T09:30:00Z",
      "message": {
        "messageId": "string",
        "role": "ROLE_USER",
        "parts": [
          {
            "text": "string",
            "raw": "string",
            "url": "string",
            "data": {},
            "metadata": {},
            "filename": "string",
            "mediaType": "string"
          }
        ],
        "contextId": "string",
        "taskId": "string",
        "metadata": {},
        "extensions": [
          "string"
        ],
        "referenceTaskIds": [
          "string"
        ]
      }
    },
    "artifacts": [
      {
        "artifactId": "string",
        "parts": [
          {
            "text": "string",
            "raw": "string",
            "url": "string",
            "data": {},
            "metadata": {},
            "filename": "string",
            "mediaType": "string"
          }
        ],
        "name": "string",
        "description": "string",
        "metadata": {},
        "extensions": [
          "string"
        ]
      }
    ],
    "history": [
      {
        "messageId": "string",
        "role": "ROLE_USER",
        "parts": [
          {
            "text": "string",
            "raw": "string",
            "url": "string",
            "data": {},
            "metadata": {},
            "filename": "string",
            "mediaType": "string"
          }
        ],
        "contextId": "string",
        "taskId": "string",
        "metadata": {},
        "extensions": [
          "string"
        ],
        "referenceTaskIds": [
          "string"
        ]
      }
    ],
    "metadata": {}
  }
}

Update an assigned A2A task

Authentication

AuthorizationBearer

Human-approved credential. Least-privilege grants are published in RFC 9728 protected-resource metadata and on each operation as x-required-permission.

Path parameters

taskIdstringRequiredformat: "^tsk_"

Request

This endpoint expects an object.

stateenumRequired

messageobjectOptional

artifactslist of objectsOptional

Response

Updated task

taskobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X POST https://api.agentmailer.ai/v1/a2a/tasks/taskId \
>	-H "Authorization: Bearer <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"state": "TASK_STATE_SUBMITTED"
>	}'