새로운 문서를 작성 중입니다.새 문서로 이동
ClawOps Docs
API Reference

콜 플로우 부분 수정

PATCH
/v1/accounts/{accountId}/call-flows/{callFlowId}

준 필드만 바꿉니다. name·graph 중 최소 하나는 있어야 하고, 둘 다 없으면 400입니다.

graph를 줄 때는 콘솔 빌더가 잡아 둔 캔버스 좌표를 보존합니다 — 공개 계약에 좌표가 없어 API로는 보낼 수 없는데, 그대로 덮으면 콘솔에서 잡아 둔 배치가 매 요청마다 날아가기 때문입니다. (좌표까지 초기화하려면 PUT을 쓰세요.)

graph는 부분 그래프가 아니라 완결된 그래프 하나여야 합니다 — 블럭 하나만 보내는 병합은 지원하지 않습니다.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

callFlowId*string

콜 플로우 ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/accounts/AC1a2b3c4d/call-flows/cmryw3ycm000001s6on0kp9a8" \  -H "Content-Type: application/json" \  -d '{}'
{
  "callFlowId": "cmryw3ycm000001s6on0kp9a8",
  "name": "고객센터 ARS",
  "phoneNumbers": [
    "07052753864"
  ],
  "variables": [
    "name"
  ],
  "dateCreated": "2026-07-24T09:12:33.000Z",
  "dateUpdated": "2026-07-27T01:40:11.000Z",
  "graph": {
    "version": 1,
    "start": "greeting",
    "voice": {
      "provider": "google",
      "language": "ko"
    },
    "nodes": {
      "greeting": {
        "type": "say",
        "text": "안녕하세요, 클로옵스입니다.",
        "next": "bye"
      },
      "bye": {
        "type": "hangup",
        "message": "이용해 주셔서 감사합니다."
      }
    }
  }
}
{
  "error": "콜 플로우 구성이 올바르지 않습니다",
  "code": "call_flow_invalid_graph",
  "issues": [
    {
      "path": "nodes.ask.timeoutSecs",
      "message": "알 수 없는 필드입니다: timeoutSecs"
    }
  ]
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}