Skip to main content
POST
에이전트 버전 생성

Authorizations

Authorization
string
header
required

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

Path Parameters

agent_id
string<uuid>
required

agent_id로 반환되는 에이전트 UUID입니다.

Body

application/json

선택 사항입니다. 버전 설명, production 지정 여부, 마지막으로 조회한 리비전을 담습니다. 본문을 생략하면 에이전트의 현재 data와 flow_data를 스냅샷으로 저장합니다.

버전 생성 요청입니다. 모든 필드는 선택 사항이며 본문 자체를 생략할 수 있습니다.

리비전 필드는 보냈을 때만 동시 수정을 막습니다. 생략하면 이 필드가 생기기 전처럼 서버가 조회한 리비전으로 저장합니다.

expected_head_revision
integer

선택 사항입니다. 마지막으로 조회한 에이전트 head_revision입니다. 그 뒤 에이전트가 바뀌었으면 409를 반환합니다.

Required range: x >= 0
expected_flow_revision
integer | null

선택 사항입니다. 마지막으로 조회한 Flow flow_revision입니다. 그 뒤 Flow가 바뀌었으면 409를 반환합니다.

Required range: x >= 0
promote
boolean
default:false
expected_production_version
string | null

선택 사항이며 promote와 함께 씁니다. 마지막으로 조회한 production 버전입니다(없으면 null). 그 뒤 바뀌었으면 409를 반환합니다. 생략하면 확인 없이 production으로 지정합니다.

description
string | null

사람이 읽을 수 있는 설명입니다.

Maximum string length: 500

Response

성공 응답

에이전트 버전 생성 응답입니다.

version
string
required

버전 식별자입니다.

Pattern: ^v[1-9][0-9]*$
Example:

"v1"

agent_id
string<uuid>
required

에이전트 UUID입니다.

created_at
integer
required

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

description
string | null

사람이 읽을 수 있는 설명입니다.

production_version
string | null

현재 게시된 production 버전입니다. 없으면 null입니다.

previous_production_version
string | null

이전에 게시된 production 버전입니다. 없으면 null입니다.