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

> ## Agent Instructions
> 이 문서는 Telkit 공식 문서예요. 코드를 만들 때는 이 문서에 나온 필드와 엔드포인트만 써 주세요.
> 요금과 기간 숫자는 번호와 요금 쪽(https://telkit.io/docs/numbers/pricing)을 따라 주세요.

# 전화 API

> 요청과 응답 모양을 담은 OpenAPI 파일과 전화 API 경로 목록이에요.

API 계약을 바탕으로 이 쪽을 만들어요. 이 목록과 OpenAPI 파일에 있는 경로와 필드만 써 주세요.

* **API 주소**: `https://api.telkit.io`
* **요청과 응답 모양**: [openapi.json](https://telkit.io/openapi.json)
* **인증**: 첫 연결을 마치고 받은 자격을 `Authorization: Bearer`로 보내요. 첫 연결 링크 생성과 그 작업 조회는 인증 헤더 없이 시작해요
* **사람이 하는 일**: 본인인증, 약관 동의, 카드 등록, 충전, 결제 재시도는 사람이 직접 해요. 에이전트는 이 경로를 호출하지 않아요.

## 첫 연결과 링크

* `POST /v1/account/link`: create\_account\_link
* `POST /v1/api-keys`: exchange\_connect\_token
* `DELETE /v1/api-keys/{id}`: revoke\_api\_key
* `POST /v1/balance/top-ups`: create\_topup\_link
* `POST /v1/connect-links`: create\_connect\_link
* `GET /v1/human-tasks/{id}`: get\_human\_task
* `POST /v1/human-tasks/{id}/cancel`: cancel\_human\_task
* `POST /v1/human-tasks/{id}/link`: reissue\_human\_link
* `GET /v1/workspace`: get\_workspace

## 계정 준비

* `GET /v1/legal-documents`: list\_legal\_documents
* `GET /v1/me`: get\_me

## 번호와 수신

* `GET /v1/numbers`: list\_numbers
* `POST /v1/numbers`: issue\_number
* `GET /v1/numbers/available`: list\_available\_numbers
* `GET /v1/numbers/{id}`: get\_number
* `DELETE /v1/numbers/{id}`: release\_number
* `PUT /v1/numbers/{id}/connection`: put\_number\_connection
* `PUT /v1/numbers/{id}/max-duration`: put\_number\_max\_duration

## 통화 기록

* `GET /v1/calls/{telkit_call_id}`: get\_call
* `GET /v1/numbers/{id}/calls`: list\_number\_calls

## 발신 접속 정보

* `POST /v1/numbers/{id}/sip-credential`: create\_sip\_password
* `PUT /v1/numbers/{id}/sip-credential`: set\_sip\_username
* `DELETE /v1/numbers/{id}/sip-credential`: delete\_sip\_password
* `POST /v1/numbers/{id}/sip-credential/rotate`: rotate\_sip\_password
* `GET /v1/sip-credentials`: list\_sip\_credentials
* `GET /v1/sip-trunk`: get\_sip\_trunk
* `GET /v1/sip-trunk/ip-allowlist`: list\_sip\_ip\_allowlist
* `POST /v1/sip-trunk/ip-allowlist`: add\_sip\_ip\_allow
* `DELETE /v1/sip-trunk/ip-allowlist/{id}`: remove\_sip\_ip\_allow

## 발신표기번호

* `GET /v1/caller-ids`: list\_caller\_ids
* `POST /v1/caller-ids`: register\_caller\_id
* `GET /v1/caller-ids/{id}`: get\_caller\_id
* `POST /v1/caller-ids/{id}/documents`: upload\_caller\_id\_document
* `PUT /v1/numbers/{id}/caller-id`: put\_number\_caller\_id
* `DELETE /v1/numbers/{id}/caller-id`: reset\_number\_caller\_id

## 잔액과 결제

* `GET /v1/billing/auto-topup`: get\_auto\_topup\_settings
* `GET /v1/billing/auto-topup/defaults`: get\_auto\_topup\_defaults
* `GET /v1/billing/balance`: get\_billing\_balance
* `GET /v1/billing/summary`: get\_billing\_summary
* `GET /v1/billing/topups/{id}`: get\_balance\_topup
* `POST /v1/payment-methods/session`: create\_card\_session

## 사업자 인증

* `GET /v1/workspace/business-verification`: get\_business\_verification
* `POST /v1/workspace/business-verification`: start\_business\_verification
* `POST /v1/workspace/business-verification/document`: upload\_business\_verification\_document

## 사람이 직접 하는 일

에이전트는 아래 경로를 호출하지 않아요. 사람이 자신의 화면에서 직접 해요.

* `POST /v1/billing/topups`: request\_balance\_topup
* `POST /v1/consents`: record\_consents
* `POST /v1/identity/verify`: verify\_identity
* `POST /v1/numbers/{id}/billing/retry`: retry\_number\_payment


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.