Skip to main content
PATCH
메뉴얼 수정

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

manual_id
string<uuid>
required

메뉴얼 UUID입니다.

Body

application/json

수정할 메뉴얼 필드입니다.

PATCH /v3/manuals/{id} 부분 업데이트 요청.

보낸 필드만 반영한다(생략 = 변경 없음). 빈 body {} 는 400(PatchRequest). 각 필드는 null 을 허용하지 않는다 — null 전송 시 400.

name
string

메뉴얼 이름입니다. 1~128자여야 합니다. 생략하면 현재 값을 유지하며, null은 허용하지 않습니다.

Required string length: 1 - 128
trigger
string

트리거 문구입니다. 생략하면 현재 값을 유지하며, null은 허용하지 않습니다.

content
string

메뉴얼 지침입니다. 생략하면 현재 값을 유지하며, null은 허용하지 않습니다. 값을 보내면 참조 토큰에서 tool_idslinked_manual_ids를 다시 계산합니다. 여기에서 제거한 참조는 해당 배열에서도 제거합니다.

built_in_tools
(EndCallTool · object | TransferCallTool · object | TransferAgentTool · object | SendSmsTool · object | SendDtmfTool · object | SearchAddressTool · object | SkillTool · object)[]

built-in 도구 설정입니다. 생략하면 변경하지 않으며, null은 허용하지 않습니다. 각 name^[a-zA-Z_][a-zA-Z0-9_]*$ 형식에 맞고 고유해야 합니다. 수정 결과의 content에서 @tool:<name> 토큰으로 참조해야 합니다.

통화 종료 built-in 도구 설정입니다.

config
ManualConfig · object

메뉴얼 실행 옵션입니다. 생략하면 현재 값을 유지하며, null은 허용하지 않습니다. 보낸 옵션을 저장된 옵션에 병합합니다. 생략한 옵션은 저장된 값을 유지하고, 옵션을 null로 보내면 해당 옵션만 지웁니다.

Response

성공 응답

manual 단건 응답(생성·조회·수정). organization_id·is_deleted 미노출.

id
string<uuid>
required

메뉴얼 UUID입니다.

name
string
required

메뉴얼 이름입니다.

trigger
string
required

트리거 문구입니다.

content
string
required

참조 토큰을 원문 그대로 유지한 메뉴얼 지침입니다.

tool_ids
string<uuid>[]
required

연결된 custom 도구 UUID입니다. content@tool:<uuid> 참조에서 계산합니다.

built_in_tools
(EndCallTool · object | TransferCallTool · object | TransferAgentTool · object | SendSmsTool · object | SendDtmfTool · object | SearchAddressTool · object | SkillTool · object)[]
required

메뉴얼에 속한 built-in 도구 설정입니다.

통화 종료 built-in 도구 설정입니다.

linked_manual_ids
string<uuid>[]
required

연결된 메뉴얼 UUID입니다. content@manual:<uuid> 참조에서 계산합니다.

config
ManualConfig · object
required

메뉴얼 실행 옵션입니다. 응답에 항상 포함하며, 설정하지 않은 옵션은 null로 반환합니다.

created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

updated_at
integer
required

리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.