Skip to main content
POST
Publish a local agent as a Library agent definition for the organization or one project (or --propose it). Requires --execute.

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Required for every non-open scope. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.

Body

application/json
id
string
required

Local agent id

description
string

What the agent does (default: its own description)

execute
boolean

Confirm the publish (without it, print the plan and exit 3)

note
string

Version note, at most 500 characters

propose
boolean

Propose it for review instead of publishing

scope
string

org, or the Console project slug the agent belongs to

slug
string

Library slug (default: the agent id)

Response

Success — body conforms to the @Returns schema.

agent
string
required
contentHash
string
required
item
object | null
required
leftOut
object[]
required
manifest
object
required
next
string | null
required
proposal
object | null
required
ref
string
required
success
boolean
required
unchanged
boolean
required
version
number | null
required