---
title: "Use Agent Tool"
method: POST
path: "/agent/use-tool"
tags: ["accepts-api-key"]
---

# Use Agent Tool

`POST /agent/use-tool`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/agent/use-tool`
- Auth: none declared

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- UseAgentToolRequest
  - `tool_id` string, required: The id of the tool to use
  - `tool_arguments` object, required: The arguments to pass to the tool

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)