Open MCP Portaldocs
ReferenceAdmin

Every call through every gateway (platform admins and auditors)

GET/v1/admin/calls

Query Parameters

gateway?string

Gateway ID

Formatuuid
server?string

MCP server ID

Formatuuid
outcome?string

ok: answered. tool_error: the tool reported an error. denied: refused by policy (logged; the client saw not found, or for a service account calling a capability that requires an account, a clear refusal). upstream_error: unreachable, refused or malformed (also provider_unavailable: the provider's token endpoint failed). bad_request: the client's request was invalid. needs_authorization: not forwarded because the person must connect or reconnect an account; the client got a consent link (JSON-RPC -32042). rate_limited: not forwarded because a rate limit was exceeded (HTTP 429, JSON-RPC -32029; errorClass names the limit: person_per_minute, credential_per_minute, service_account_per_minute or gateway_per_minute).

Value in

  • "ok"
  • "tool_error"
  • "denied"
  • "upstream_error"
  • "timeout"
  • "too_large"
  • "bad_request"
  • "needs_authorization"
  • "rate_limited"
user?string

Only calls made by this person (any credential)

Formatuuid
serviceAccount?string

Only calls made by this service account

Formatuuid
team?string

Team slug or ID (calls through its gateways, to its servers, or by its service accounts)

from?string

Entries at or after this time

Formatdate-time
to?string

Entries before this time (exclusive)

Formatdate-time
cursor?string

nextCursor from the previous page

limit?integer
Range1 <= value <= 200
Default50

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/admin/calls"
{  "data": {    "items": [      {        "id": 0,        "occurredAt": "2019-08-24T14:15:22Z",        "method": "tools/call",        "exposedName": "string",        "gateway": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "slug": "string",          "name": "string",          "exists": true        },        "server": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "slug": "string",          "name": "string",          "exists": true        },        "principal": {          "kind": "api_key",          "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",          "displayName": "string",          "email": "string",          "apiKeyName": "string",          "oauthClientName": "string",          "oauthClientVerified": true,          "serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",          "serviceAccountTeamSlug": "string",          "serviceAccountExists": true        },        "clientName": "string",        "outcome": "ok",        "errorClass": "string",        "providerSlug": "string",        "latencyMs": 0,        "requestBytes": 0,        "responseBytes": 0,        "requestId": "string",        "captured": true      }    ],    "nextCursor": "string"  }}