API Reference

Agents

View as Markdown

View as Markdown

Copy Markdown

---

Open in Claude

Open in ChatGPT

Tools

List Tools For Agent

client.agents.tools.list(stringagentID, ToolListParams { after, before, limit, 2 more } query?, RequestOptionsoptions?): ArrayPage<Tool { id, args_json_schema, created_by_id, 14 more } >

get/v1/agents/{agent_id}/tools

Attach Tool To Agent

client.agents.tools.attach(stringtoolID, ToolAttachParams { agent_id } params, RequestOptionsoptions?): AgentState { id, agent_type, blocks, 39 more } | null

patch/v1/agents/{agent_id}/tools/attach/{tool_id}

Detach Tool From Agent

client.agents.tools.detach(stringtoolID, ToolDetachParams { agent_id } params, RequestOptionsoptions?): AgentState { id, agent_type, blocks, 39 more } | null

patch/v1/agents/{agent_id}/tools/detach/{tool_id}

Modify Approval For Tool

client.agents.tools.updateApproval(stringtoolName, ToolUpdateApprovalParams { agent_id, query_requires_approval } params, RequestOptionsoptions?): AgentState { id, agent_type, blocks, 39 more } | null

patch/v1/agents/{agent_id}/tools/approval/{tool_name}