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}$
tool_call_id
string
required

The tool call that is waiting on this interaction — the guarded tool for a permission, or the ask_question call for a question.

Pattern: ^tcl_[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
tool_name
string

The tool whose invocation a permission interaction guards. Present only when interaction_kind is permission.

agent_name
string

Agent name. Empty means the agent is unnamed; non-empty values use the ResourceName policy.

Maximum string length: 64
subagent_key
string

Present when the interaction belongs to a subagent of the listed agent.

resolution
object
destination
object

Captured built-in integration destination. Absent for dashboard-only or older interactions; never reconstructed from the current agent selection.

presentation_receipt
object

Confirmed provider presentation metadata, when recorded. This is not an execution grant or a delivery guarantee. Absence does not prove a remote send failed. Customer-hosted presenters maintain their own delivery records.

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 resolutions without an attributed input. The input's actor_id attributes the resolution.

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