콜 플로우 전체 교체

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": "google",
      "language": "ko"
    }
  }
}

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

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

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

플로우를 통째로 바꿉니다. `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를 넘을 수 없습니다.

콜 플로우 그래프 — **요청용**. 블럭(`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

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

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