ToolCall

Tool calls: every integration run, capability call and agent tool call your platform work made, newest first.

page = noclick.ToolCall.list_page(tool="gmail.*", status="error", user_filter=noclick.ALL_USERS)

class ToolCall

One recorded tool call.

Attributes

id	string
toolName	string	The name policy judges it by: dotted (`gmail.send_email_message`), or a capability's own (`search`, `fetch`, an agent's too).
toolType	string \| null
operation	string \| null
status	string \| null
error	string \| null
arguments	JsonObject
resultPreview	string \| null
durationMs	number \| null
credentialId	string \| null
userId	string \| null
agentId	string \| null
conversation	string \| null
executionId	string \| null
source	string \| null	`api`, `agent` or `mcp_server`.
createdAt	Date \| null
raw	JsonObject	The response JSON exactly as the API sent it.
mcpServerId	string \| null	The hosted MCP server an MCP client called it through (`source` `mcp_server`).

liststatic

static list(options?: ToolCallFilters & { limit?: number }): Promise<ToolCall[]>

Every matching call (or the first limit).

Parameters

options.agentstring | ApiObject

An Agent or agent id: its turns' calls.

options.toolstring

A tool name or a * pattern (gmail.*), dotted or wire form.

options.status"success" | "error"

options.source"api" | "agent" | "mcp_server"

api: your own calls; agent: your agents' turns; mcp_server: MCP clients' calls through your hosted servers.

options.sinceDate | string

options.untilDate | string

options.limitnumber

Return at most this many.

options.userFilterUserFilter

Which users the read covers (user_id query), instead of acting as one (user).

options.userUserOption

undefined = the ambient user (asUser), null = the account itself.

(defaults to the current user)

options.clientNoClick

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

Returns

Every matching call, newest first, fetched page by page.

listPagestatic

static listPage(
  options?: ToolCallFilters & PageOptions,
): Promise<Page<ToolCall>>

One page of matching calls; pass nextCursor back as cursor.

Parameters

options.cursorstring | null

The next_cursor of the page before; omit it for the first page.

options.limitnumber

Return at most this many.

options.agentstring | ApiObject

An Agent or agent id: its turns' calls.

options.toolstring

A tool name or a * pattern (gmail.*), dotted or wire form.

options.status"success" | "error"

options.source"api" | "agent" | "mcp_server"

api: your own calls; agent: your agents' turns; mcp_server: MCP clients' calls through your hosted servers.

options.sinceDate | string

options.untilDate | string

options.userFilterUserFilter

Which users the read covers (user_id query), instead of acting as one (user).

options.userUserOption

undefined = the ambient user (asUser), null = the account itself.

(defaults to the current user)

options.clientNoClick

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

Returns

A page whose data holds up to limit calls (at most 200) and whose next_cursor is None on the last page.

summarystatic

static summary(options?: ToolCallFilters): Promise<ToolCallSummary>

How many calls match, and how many of them errored.

Parameters

options.agentstring | ApiObject

An Agent or agent id: its turns' calls.

options.toolstring

A tool name or a * pattern (gmail.*), dotted or wire form.

options.status"success" | "error"

options.source"api" | "agent" | "mcp_server"

api: your own calls; agent: your agents' turns; mcp_server: MCP clients' calls through your hosted servers.

options.sinceDate | string

options.untilDate | string

options.userFilterUserFilter

Which users the read covers (user_id query), instead of acting as one (user).

options.userUserOption

undefined = the ambient user (asUser), null = the account itself.

(defaults to the current user)

options.clientNoClick

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

Returns

The total, split into success and error.

ToolCallSummary

interface ToolCallSummary

How many calls match, and how many of them errored.

Attributes

total	number
success	number
error	number
raw	JsonObject	The response JSON exactly as the API sent it.