---
title: "Task state change"
method: POST
path: "taskUpdate"
---

# Task state change

`POST taskUpdate` (webhook)

Fired when a task transitions state

## Payload

- object
  - `agentId` string
  - `event` 'task.submitted' | 'task.working' | 'task.completed' | 'task.failed' | 'task.canceled'
  - `task` Task
    - `artifacts` Artifact[]
      - `artifactId` string
      - `description` string
      - `metadata` object
      - `name` string
      - `parts` Part[]
        - `data` object
        - `file` object
          - `mimeType` string
          - `name` string
          - `uri` string
        - `kind` 'text' | 'data' | 'file'
        - `text` string
        - `type` 'text' | 'data' | 'file'
    - `contextId` string
    - `messages` Message[]
      - `messageId` string
      - `metadata` object
      - `parts` Part[]
        - `data` object
        - `file` object
          - `mimeType` string
          - `name` string
          - `uri` string
        - `kind` 'text' | 'data' | 'file'
        - `text` string
        - `type` 'text' | 'data' | 'file'
      - `role` 'user' | 'agent'
    - `metadata` object
    - `status` TaskStatus
      - `message` Message
        - `messageId` string
        - `metadata` object
        - `parts` Part[]
          - `data` object
          - `file` object
            - `mimeType` string
            - `name` string
            - `uri` string
          - `kind` 'text' | 'data' | 'file'
          - `text` string
          - `type` 'text' | 'data' | 'file'
        - `role` 'user' | 'agent'
      - `state` 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'rejected'
      - `timestamp` string, date-time
    - `taskId` string
  - `timestamp` string, date-time

## Acknowledgement `202`

Webhook accepted

## Other responses

- `400` — Invalid request parameters

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/revisions/fb85a82845ac/schema)