> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telloai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# tasks/cancel

> 진행 중인 통화를 끊고 태스크를 취소해요.

## 할 수 있는 일

태스크를 취소해요. 통화가 진행 중이면 통화도 함께 끊겨요.

## 요청

```bash theme={null}
curl -X POST "https://api.telloai.io" \
  -H "Authorization: Bearer <YOUR_A2A_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tasks/cancel",
    "params": { "id": "<TASK_ID>" }
  }'
```

## 파라미터

| 필드          | 필수 | 설명                   |
| ----------- | -- | -------------------- |
| `params.id` | 필수 | 통화 시작 응답에서 받은 taskId |

## 결과

`canceled` 상태의 태스크 스냅샷이 와요. 열려 있던 스트림에도 종단 상태로 전달돼요.

## 오류

| 코드                           | 언제         |
| ---------------------------- | ---------- |
| `task_not_found`             | 없는 태스크     |
| `session_principal_mismatch` | 다른 계정의 태스크 |

## 주의사항

* 이미 종단 상태인 태스크에 호출하면 그 상태 그대로 돌아와요.
* 상대가 말하는 도중에 취소하면 그 발화는 스트림에 오지 않아요.

## 관련 문서

* [tasks/get](/developer/a2a/methods/tasks-get)
* [태스크 상태](/developer/a2a/task-states)
* [외부에서 호출받기](/developer/a2a/inbound)