Skip to main content
GET
Get a tool call

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

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

Project ID (proj_...).

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

Agent ID (agt_...).

Pattern: ^agt_[a-z2-7]{26}$
toolCallID
string
required

Tool call ID (tcl_...).

Pattern: ^tcl_[a-z2-7]{26}$

Response

Tool call.

A model-emitted tool call together with its current lifecycle state.

id
string
required
Pattern: ^tcl_[a-z2-7]{26}$
agent_id
string
required
Pattern: ^agt_[a-z2-7]{26}$
turn_id
string
required
Pattern: ^trn_[a-z2-7]{26}$
provider_call_id
string
required
name
string
required
input
object
required

Non-null JSON object containing the arguments emitted for a tool call.

type
enum<string>
required

Identifies who manages execution. Built-in and MCP calls are platform-managed; custom calls wait for an external consumer to submit their result.

Available options:
built_in,
custom,
mcp
state
enum<string>
required

Current lifecycle state. awaiting_authorization has not evaluated its permission mode; awaiting_permission has an open authorization prompt; ready is authorized and eligible to run; running has an active worker; waiting has durable work that will complete the call independently; completed is terminal and includes outcome and completed_at. Custom calls remain ready until a consumer submits their result.

Available options:
awaiting_authorization,
awaiting_permission,
ready,
running,
waiting,
completed
created_at
string<date-time>
required
outcome
enum<string>

Terminal outcome, present only when state is completed.

Available options:
succeeded,
failed,
denied,
canceled
completed_at
string<date-time>