Skip to main content
POST
Submit a result for a ready custom tool call

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

Body

application/json
outcome
enum<string>
required

Whether the custom tool call succeeded or failed.

Available options:
succeeded,
failed
content_blocks
object[]
required

At most 20 inline media blocks per submission, each holding up to 10 MiB of decoded media and up to 24 MiB decoded across the submission. Non-media blocks may hold up to 1 MiB combined. The whole request body is capped at 48 MiB.

Submission accepts inline media. The persisted response exposes that media as a media_ref block.

Response

Custom tool result accepted and tool call completed.

tool_call
object
required

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

tool_result
object
required