Skip to main content
POST
Create agent

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}$

Body

application/json
config
string
required
Pattern: ^acfg_[a-z2-7]{26}$
profile
string
Pattern: ^aprf_[a-z2-7]{26}$
name
string

Optional agent name. Omit to inherit the profile name when present; send an empty string to leave the agent unnamed.

Maximum string length: 64
message
string

Response

Current state of the previously created agent.

agent
object
required