> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.claw-ops.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.claw-ops.com/_mcp/server.

# 인증 취소

DELETE https://api.claw-ops.com/v2/verifications/{verificationId}

진행 중인 인증을 취소합니다. **204 가 아니라 200 과 함께 리소스를 돌려줍니다** — 취소 시각이 필요하기 때문입니다. 이미 끝난 건은 `422 already_settled` 입니다.

Reference: https://docs.claw-ops.com/api-reference/claw-ops-api/verifications/cancel-verification

## Authentication

- `Authorization` header (bearer token, required) — API Key를 Bearer 토큰으로 전달

## Request

### Path parameters

- `verificationId` (string, required)

## Response

### 200

취소됨 — `status` 가 `canceled` 로 바뀝니다

- `verificationId` (string, optional)
- `status` (enum, optional) — - `pending` — 코드를 기다리는 중 - `verified` — 통과. **1회용입니다** — 같은 건을 두 번 소비할 수 없습니다 - `expired` — `ttlSeconds` 가 지남 - `max_attempts` — 대조 5회를 모두 사용 - `canceled` — 취소했거나, 같은 번호의 다른 건이 먼저 통과함 - `failed` — 전달 자체가 실패(문자 발송 실패, 통화 미응답·실패)
  - Allowed values: `pending`, `verified`, `expired`, `max_attempts`, `canceled`, `failed`
- `channel` (enum, optional)
  - Allowed values: `sms`, `call`
- `to` (string, optional)
- `from` (string, optional) — 발신에 쓴 계정 보유 번호.
- `codeLength` (integer, optional)
- `remainingAttempts` (integer, optional) — 남은 대조 횟수. 건당 5회에서 시작합니다.
- `expiresAt` (datetime, optional)
- `createdAt` (datetime, optional)
- `verifiedAt` (datetime, optional, nullable)
- `instruction` (VerificationInstruction, optional, nullable) — 사용자에게 **그대로 보여 줘야 하는 것**. 발신형(`sms`·`call`)은 우리가 사용자에게 코드를 전달하므로 `null` 입니다. 수신형 채널이 열리면 보낼 번호와 문구가 여기 담깁니다.

## Errors

### 401 Unauthorized Error

인증 실패

- `error` (string, optional) — 사람이 읽을 수 있는 에러 메시지
- `code` (string, optional) — 기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서 바뀔 수 있지만 코드는 계약입니다. 같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는 - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서 해제해야 발신됩니다. - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다. 전화번호 정규화 관련: - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님) - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)
- `ip` (string, optional) — `overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다. 해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔 「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.

### 404 Not Found Error

없거나 다른 계정의 건 (`verification_not_found`)

- `error` (string, optional) — 사람이 읽을 수 있는 에러 메시지
- `code` (string, optional) — 기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서 바뀔 수 있지만 코드는 계약입니다. 같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는 - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서 해제해야 발신됩니다. - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다. 전화번호 정규화 관련: - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님) - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)
- `ip` (string, optional) — `overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다. 해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔 「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.

### 422 Unprocessable Entity Error

이미 끝난 인증 (`already_settled`)

- `error` (string, optional) — 사람이 읽을 수 있는 에러 메시지
- `code` (string, optional) — 기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서 바뀔 수 있지만 코드는 계약입니다. 같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는 - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서 해제해야 발신됩니다. - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다. 전화번호 정규화 관련: - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님) - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)
- `ip` (string, optional) — `overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다. 해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔 「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.

## Types

### VerificationInstruction

사용자에게 **그대로 보여 줘야 하는 것**. 발신형(`sms`·`call`)은 우리가 사용자에게 코드를 전달하므로 `null` 입니다. 수신형 채널이 열리면 보낼 번호와 문구가 여기 담깁니다.

- `type` (string, optional)
- `sendTo` (string, optional)
- `body` (string, optional)
- `callTo` (string, optional)
- `code` (string, optional)
- `deadline` (datetime, optional)

## Examples

**Response**

```json
{
  "verificationId": "VE1a2b3c4d5e6f7a8b",
  "status": "pending",
  "channel": "sms",
  "to": "01012345678",
  "from": "07052358010",
  "codeLength": 6,
  "remainingAttempts": 5,
  "expiresAt": "2024-01-15T09:30:00Z",
  "createdAt": "2024-01-15T09:30:00Z",
  "verifiedAt": "2024-01-15T09:30:00Z",
  "instruction": {
    "type": "string",
    "sendTo": "string",
    "body": "string",
    "callTo": "string",
    "code": "string",
    "deadline": "2024-01-15T09:30:00Z"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.delete("https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b");
var request = new RestRequest(Method.DELETE);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.claw-ops.com/v2/verifications/VE1a2b3c4d5e6f7a8b")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "DELETE"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```