콜 플로우 전체 교체

curl -X PUT https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/call-flows/cmryw3ycm000001s6on0kp9a8 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "동의 확인 ARS (문구 수정)",
  "graph": {
    "version": 1,
    "start": "ask",
    "nodes": {
      "agreed": {
        "type": "hangup",
        "message": "동의해 주셔서 감사합니다."
      },
      "ask": {
        "type": "menu",
        "branches": {
          "1": "agreed",
          "2": "declined"
        },
        "invalidNext": null,
        "prompt": "안내에 동의하시면 1번, 거부하시면 2번을 눌러주세요.",
        "saveAs": "consent",
        "timeoutNext": "noInput"
      },
      "declined": {
        "type": "hangup",
        "message": "확인했습니다. 감사합니다."
      },
      "noInput": {
        "type": "hangup",
        "message": "입력이 없어 통화를 종료합니다."
      }
    }
  }
}'

{
  "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",
    "nodes": {
      "bye": {
        "type": "hangup",
        "message": "이용해 주셔서 감사합니다."
      },
      "greeting": {
        "type": "say",
        "next": "bye",
        "text": "안녕하세요, 클로옵스입니다."
      }
    },
    "voice": {
      "provider": "clawops",
      "language": "ko"
    }
  }
}

플로우를 통째로 바꿉니다. name·graph 둘 다 필수이고, 보낸 그래프가 저장된 그래프를 완전히 대체합니다.

콘솔 빌더가 잡아 둔 캔버스 좌표는 버려집니다(REST의 PUT 의미 그대로). 좌표가 없어도 콘솔 에디터가 자동 배치로 받아주므로 화면이 깨지지는 않습니다. 좌표를 지키려면 PATCH를 쓰세요.

검증과 에러 형태는 생성(POST)과 같습니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

callFlowIdstringRequired

콜 플로우 ID

Request

This endpoint expects an object.

namestringRequired<=80 characters

플로우 이름

graphobjectRequired

콜 플로우 그래프 — 요청용. 블럭(nodes)과 시작점(start)으로 통화 흐름 전체를 기술합니다.

⚠️ 요청과 응답의 형태가 다릅니다. 기본값이 있는 필드(menu.maxDigits·menu.timeoutSec, record.maxLengthSec·playBeep·finishKey, dial.timeoutSec, voice.language, optout.number·channel)는 요청에서 생략할 수 있고, 응답에는 항상 채워져 돌아옵니다.

캔버스 좌표(ui)는 공개 계약 밖입니다 — 보내도 저장되지 않고, 응답에도 실리지 않습니다. 콘솔 빌더가 잡아 둔 좌표는 PUT이면 버려지고 PATCH면 보존됩니다.

그래프 전체는 256KB를 넘을 수 없습니다.

Response

교체 성공

callFlowIdstringOptional

콜 플로우 ID. createCall의 CallFlowId, 번호 라우팅의 callFlowId에 그대로 사용합니다.

namestringOptional

콜 플로우 이름

phoneNumberslist of stringsOptional

이 플로우로 인입되는 번호 목록(routingType=callflow). 아웃바운드 전용이면 빈 배열입니다.

variableslist of stringsOptional

발신 시 createCall의 Variables로 넣어야 하는 변수 이름들. 그래프가 {{이름}}으로 참조하지만 통화 중에는 만들어지지 않는 값입니다(누른 키·HTTP 응답·녹음 결과처럼 통화가 만들어내는 변수는 제외). 채우지 않으면 그 자리는 빈 문자열로 나갑니다.

dateCreateddatetimeOptional

dateUpdateddatetimeOptional

graphobject or nullOptional

블럭 구성. 저장된 그래프가 현재 스키마로 읽히지 않으면(콘솔이 아닌 경로로 손댄 아주 오래된 플로우) null입니다 — 이름·연결된 번호는 그대로 유효하며, 이 경우 PUT으로 그래프 전체를 다시 올려 고칠 수 있습니다.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

413

Content Too Large Error