Skip to main content
GET
/
agents
/
{agentId}
/
tools
JavaScript
import Cerca from '@cerca-dev/sdk';

const client = new Cerca({
  apiKey: process.env['CERCA_API_KEY'], // This is the default and can be omitted
});

const response = await client.agents.listTools('agent_abc123');

console.log(response.tools);
{
  "tools": [
    {
      "description": "<string>",
      "inputSchema": {
        "type": "object"
      },
      "requiresApproval": true
    }
  ],
  "sourceWarnings": [
    {
      "message": "<string>",
      "source": "<string>",
      "sourceId": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.cerca.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agentId
string
required
Minimum string length: 1
Example:

"agent_abc123"

Response

Unified list of runtime and external tools currently available to an agent.

Response for GET /agents/{agentId}/tools. The tools field is an inspection list, not a configuration request field.

​
tools
(RuntimeInternalTool · object | RuntimeExternalTool · object)[]
required

Unified list of runtime and external tools currently available to the agent.

A unified available tool entry. Runtime tools include requiresApproval; external tools include approval.

​
sourceWarnings
object[]