Skip to main content
API reference sections

Schema

ToolFailure

Why a tool call did not work, classified by the adapter from the structured fields it already reads.

Five classes and no sixth escape hatch that carries text. A provider that failed a call in a way the adapter cannot place is [Unclassified](Self::Unclassified) - which is a fact worth showing ("it failed, and the provider did not say how") and is never a guess.

Type "denied" or "cancelled" or "timed_out" or "errored" or "unclassified"

Shape

One of 5 shapes:

  1. Variant 1

    It was not allowed to run - an approval refused, a permission denied.

    "denied"

  2. Variant 2

    It was stopped before it finished.

    "cancelled"

  3. Variant 3

    It ran out of time.

    "timed_out"

  4. Variant 4

    It ran and reported an error.

    "errored"

  5. Variant 5

    It did not succeed, and the provider did not say why in a way this adapter can place.

    "unclassified"

Example
"denied"

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated .

Privacy choices

Choose which optional tools Koru may use on this site. Your choice is saved in a cookie in this browser for 12 months. Privacy policy

Privacy choices

Keep you signed in, protect forms and remember your language and this choice.

Always on

PostHog and Google Analytics 4 measure page views and actions such as downloads, using cookies or local storage.

PostHog records how pages are used, with form inputs masked and private pages excluded. Needs Analytics.

Ahrefs Web Analytics measures visits and where they come from, and Google Ads measures whether our ads led to a visit or download.