Skip to main content
POST
Update agent config

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Headers

Idempotency-Key
string

Idempotency key for replay-safe mutating requests.

Required string length: 1 - 255

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
projectID
string
required
Pattern: ^proj_[a-z2-7]{26}$
agentID
string
required
Pattern: ^agt_[a-z2-7]{26}$

Body

application/json

Replaces a live agent's config. expected_current_config_id makes the change conditional on the agent still running that config, so concurrent editors get a conflict instead of silently overwriting each other.

source
string
required
Minimum string length: 1
source_format
enum<string>
required
Available options:
yaml,
json
expected_current_config_id
string
Pattern: ^acfg_[a-z2-7]{26}$

Response

Agent config updated.

agent_config
object
required
agent_input
object
required
event_id
string
required
Pattern: ^evt_[a-z2-7]{26}$