Skip to main content
POST
Public Import Agent

Authorizations

X-API-Key
string
header
required

Query Parameters

mode
enum<string>
default:clone

Operator control over how a bundle's artifacts land in the target.

  • version: keep the bundle's IDs. If the artifact already exists in the target workspace, append a new version row (Workflow/Assistant) or refuse with NOT_VERSIONABLE (KB/Inbox — use replace). If not, create with the bundle's id. Lineage history is appended on every successful artifact write.
  • clone: today's default — fresh UUIDs everywhere, no history.
  • replace: keep IDs, overwrite the active definition in place. No version row. Lineage history is appended.
Available options:
version,
clone,
replace
activate
boolean
default:false
on_missing_dependency
enum<string>
default:fail
Available options:
fail,
warn
dry_run
boolean
default:false

Body

application/json
definition
string
required
Maximum string length: 104857600
version
enum<string>
default:auto

Payload format. auto (default) detects it from the content; v3 / v4 force the base64 / YAML parse path.

Available options:
auto,
v3,
v4

Response

Successful Response

reference
string
required
type
enum<string>
required
Available options:
kb,
workflow,
assistant,
file,
inbox,
connection,
secret,
deployment
version
string | null
name
string | null
icon
string | null