Usage

Tool gateway call log

One row per tool call, newest first: which tool, which key, status, latency, guardrail outcome and error code. Never the arguments or the result — they are not stored. band is errors (failed calls — since 2026-09-27 NOT the calls a rule stopped or whose answer the guardrail withheld), stopped (calls a rule stopped before the tool: approval, a limit, the guardrail on the arguments) or guardrail; endpoint narrows to one tool (mcp:<server>/<tool>). Keyset-paginated: pass the previous response's nextCursor as cursor. Requires usage:read.

get/client/usage/tools/calls

Request

  • Base URL: https://api.roar-ai.com
  • URL: https://api.roar-ai.com/client/usage/tools/calls
  • Auth: HTTP bearer

Query parameters

fromstring date-time
tostring date-time
keyIdstring uuid
band'all' | 'errors' | 'stopped' | 'guardrail'
endpointstring
limitinteger
cursorstring

Response

Tool calls, newest first

nextCursorstring nullable required

Pass back as cursor for the next page; null on the last

Changes

No recorded changes to this operation across all 1 revision of this API.