Skip to main content
POST
Resolve agent interaction

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

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}$
interactionID
string
required
Pattern: ^int_[a-z2-7]{26}$

Body

application/json
answers
object[]
required
Minimum array length: 1
actor
object

External actor to attribute to the generated interaction_response agent input, upserted by (provider_tenant_id, provider_user_id) atomically with the resolution; a rejected request writes no actor. Only allowed for non-user principals; requests authenticated as a user must omit it and are attributed to the user's omnara actor. When a non-user request omits it, the generated input has no actor attribution.

Response

Agent interaction resolved.

id
string
required
Pattern: ^int_[a-z2-7]{26}$
org_id
string
required
Pattern: ^org_[a-z2-7]{26}$
project_id
string
required
Pattern: ^proj_[a-z2-7]{26}$
agent_id
string
required
Pattern: ^agt_[a-z2-7]{26}$
interaction_kind
enum<string>
required
Available options:
permission,
question
state
enum<string>
required
Available options:
open,
resolved,
canceled
request
object
required
created_at
string<date-time>
required
resolution
object
resolved_by_input_id
string

The agent input that resolved the interaction — the submitted response, the content input that superseded it, or the cancel control input. Absent on open interactions and on system resolutions such as prompt delivery failure. The input's actor_id attributes the resolution.

Pattern: ^ain_[a-z2-7]{26}$
resolved_at
string<date-time>