List tool calls
Il registro delle chiamate: one row per tool call made in this organisation, newest first, with the tool, the credential’s label, the outcome, how long it took and how many rows came back. You see only the calls made under your own name unless you are an administrator, so do not report what comes back as the organisation’s total. This is METERING and observability, NOT an audit trail — for the hash-chained record of what actually changed call custodo_search_audit instead. Raw rows age out at the tenant’s callLogRetentionDays, so for anything older than that window call integrazioni_list_usage.
Examples
- What have our assistants been doing? GET /api/v1/rest/integrazioni/calls?limit=50
- Quali chiamate sono state rifiutate? GET /api/v1/rest/integrazioni/calls?outcome=denied
- Did the document search fail for anyone? GET /api/v1/rest/integrazioni/calls?tool_key=documents_search&outcome=failed
Request
- Base URL: https://api.custodo.ai
- URL: https://api.custodo.ai/api/v1/rest/integrazioni/calls
- Auth: HTTP bearer
Query parameters
One tool, e.g. documents_search. Bounded text and not an enum on purpose: a row may name a tool this build has retired, and filtering by it must still work.
ok; tool_error (a business rule refused, the model could retry differently); denied (a gate said no — module, permission, scope or tier); failed (an internal error).
Rows to return, 1–100. Default 25. Newest first; there is no cursor.
Headers
The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.
Response
Done. data is the tool’s own answer.
Changes
No recorded changes to this operation across all 1 revision of this API.