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 | SkillTool · object)[]

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

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

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 | SkillTool · object)[]
required

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

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

linked_manual_ids
string<uuid>[]
required

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

created_at
integer
required

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

updated_at
integer
required

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