Skip to main content
POST
Create a version

Authorizations

Authorization
string
header
required

Enter your API key (Bearer token)

Headers

Idempotency-Key
string

Optional. A retry with the same key and body returns the first response instead of doing the work twice.

Path Parameters

id
string
required

Agent id (UUID).

Body

application/json
name
string
required
Required string length: 1 - 255
description
string | null

A short note for people. null clears it.

Maximum string length: 2000
from_version_id
string<uuid>

Branch from this version. Default: the live version.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

agent_id
string
required
created_at
string
required
description
string | null
required
draft_pending
boolean
required
head_commit
object | null
required
id
string
required
is_live
boolean
required
name
string
required
revision
string | null
required
status
string
required
changed_fields
string[]
draft
object | null
next_action
object
try_it
object

Ways to hear the live agent now. Left out when nothing is callable.

warnings
object[]