> ## Documentation Index > Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt > Use this file to discover all available pages before exploring further. # Post agents a2atasks update ## OpenAPI ````yaml /openapi.json post /agents/{agentId}/a2a/tasks/{taskId}/update openapi: 3.1.1 info: title: Anima API version: 0.1.0 description: >- The Anima API provides programmatic access to unified infrastructure for AI agents: create and manage agents; send and receive email; place phone calls and send/receive SMS and voice; store and retrieve vault credentials; manage agent identity; and configure webhooks for real-time events. Authenticate using a Bearer token or an API key passed via the X-API-Key header. contact: name: Anima Labs url: https://useanima.sh email: support@useanima.sh license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.useanima.sh/v1 description: Production security: - BearerAuth: [] - ApiKeyAuth: [] tags: - name: Agents description: Create and manage AI agents with email and phone capabilities - name: Inboxes description: Manage email inboxes and their configurations - name: Messages description: Send, receive, and search email messages - name: Webhooks description: Register and manage webhook subscriptions for real-time events - name: Organizations description: Manage organizations and team settings - name: Domains description: Configure and verify custom email domains - name: Phone description: Manage phone numbers and SMS/voice capabilities - name: Invoices description: Track invoices, match receipts, and reconcile payments - name: Billing description: View usage, tiers, and billing information - name: Security description: Configure security policies and access controls - name: Vault description: Store and retrieve encrypted secrets - name: API Keys description: Create and manage API keys for programmatic access paths: /agents/{agentId}/a2a/tasks/{taskId}/update: post: operationId: a2a.updateTask parameters: - name: agentId in: path required: true schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ description: ID of the receiving agent that owns the task - name: taskId in: path required: true schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ description: ID of the task to update requestBody: required: true content: application/json: schema: type: object properties: status: enum: - working - input_required - completed - failed type: string description: >- New task status. Terminal states (completed/failed/canceled) are immutable once reached. output: type: object additionalProperties: {} description: Task output payload (typically set when completing) error: type: object properties: code: type: string minLength: 1 maxLength: 100 description: Error code message: type: string minLength: 1 maxLength: 2000 description: Error message required: - code - message description: Error details — only allowed when status is 'failed' message: type: string maxLength: 2000 description: Human-readable annotation recorded in the task history required: - status description: >- Owner-driven A2A task status transition (the receiving agent reports working/completed/failed) responses: '200': description: OK content: application/json: schema: type: object properties: id: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ description: Unique task identifier agentId: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ description: ID of the receiving agent orgId: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ description: Organization that owns the receiving agent fromDid: type: string description: Sender DID toDid: type: string description: Receiver DID type: type: string description: Task type status: enum: - submitted - working - input_required - completed - failed - canceled type: string description: Current status of the A2A task input: type: object additionalProperties: {} description: Task input payload output: anyOf: - type: object additionalProperties: {} - type: 'null' description: Task output payload error: anyOf: - type: object properties: code: type: string description: Error code message: type: string description: Error message required: - code - message - type: 'null' description: Error details if task failed history: type: array items: type: object properties: status: enum: - submitted - working - input_required - completed - failed - canceled type: string description: Current status of the A2A task message: type: string description: Human-readable status message timestamp: type: string format: date-time description: ISO-8601 timestamp of the event required: - status - timestamp description: A single status-change event in the task history description: Status change history createdAt: type: string format: date-time description: Task creation timestamp updatedAt: type: string format: date-time description: Last update timestamp required: - id - agentId - orgId - fromDid - toDid - type - status - input - output - error - history - createdAt - updatedAt description: Full A2A task representation components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer ApiKeyAuth: type: apiKey in: header name: X-API-Key description: 'API key for programmatic access. Pass as: X-API-Key: ' ````