Skip to main content
Invoke a tool synchronously (or enqueue a job for job-backed tools)

Authorizations

Authorization
string
header
required

Authorization: Bearer stefan_sk_... (API key — bills the API wallet) or stefan_oat_... (OAuth member token — bills your plan pool).

Headers

Idempotency-Key
string

Safe blind retries on submit tools and ask_stefanbrain: resubmitting the same key within a 24-hour window (UTC day) returns the ORIGINAL job envelope — same job_id, no new work, no second charge. Injected as the idempotency_key tool argument; ignored on other tools. 1-128 chars of A-Z a-z 0-9 _ . : -; invalid values are 400 invalid_idempotency_key.

Pattern: ^[A-Za-z0-9_.:-]{1,128}$

Path Parameters

toolName
string
required

Body

application/json
arguments
object

Tool arguments matching the tool's inputSchema.

chat
string

Optional chat pin (chat_...).

project
string

Optional project pin (proj_...).

Response

Synchronous tool result.

Synchronous tool result envelope.

object
string
Allowed value: "tool_result"
request_id
string
tool
string
chat
string
project
string
is_error
boolean
content
object[]
structured_content
object | null
error
object | null

Structured failure classification; an object exactly when is_error is true, null otherwise.