Skip to main content
POST

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

chat_id
string<uuid>
required

채팅 ID입니다.

Body

application/json

사용자 메시지와 중복 전송 방지 키입니다. 에이전트 응답을 기다린 뒤 결과를 반환합니다.

text
string
required

사용자 메시지 텍스트입니다.

Minimum string length: 1
client_idempotency_key
string
required

채팅 안에서 사용자 메시지를 식별하는 멱등 키입니다. 같은 키를 다시 보내면 에이전트 턴을 재실행하지 않고 저장된 결과를 반환합니다.

Required string length: 1 - 128
images
(ChatMessageFileKeyImageInput · object | ChatMessageBase64ImageInput · object | ChatMessageUrlImageInput · object)[] | null

선택 이미지 입력입니다. 최대 3장까지 지원합니다.

Required array length: 1 - 3 elements

Response

성공 응답

chat_id
string<uuid>
required

채팅 ID입니다.

chat_status
enum<string>
required

이번 턴이 완료된 상태입니다. ended는 이 턴이 채팅을 종료했음을 뜻합니다.

Available options:
active,
ended
input_message_id
integer
required

처리한 사용자 메시지 ID입니다.

output
(ChatTurnAgentMessageResponse · object | ChatToolCallInvocationResponse · object | ChatToolCallResultResponse · object)[]
required

이번 턴에서 생성된 도구 호출, 도구 결과, 에이전트 메시지입니다.

Minimum array length: 1