Add a tool

Authorization

TokenAuth

Authorization<token>

Project API key as Token lb-sk_...

In: header

Path Parameters

name*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

description?string

http*

parameters?

JSON Schema for the tool arguments.

auth_header?string

Header to inject a server-side secret into (the model never sees it).

secret_ref?string

Project secret name (see /v1/secrets); required with auth_header.

rate_per_min?integer

Per-tenant per-tool rate limit.

allowed_hosts?array<string>

Optional explicit host allow-list (defense-in-depth over the SSRF guard).

Response Body

`application/json`

curl -X POST "https://example.com/v1/agents/string/tools" \  -H "Content-Type: application/json" \  -d '{    "name": "lookup_order",    "description": "Look up an order by id.",    "http": {      "url": "https://api.example.com/orders",      "method": "POST"    },    "parameters": {      "type": "object",      "properties": {        "order_id": {          "type": "string"        }      },      "required": [        "order_id"      ]    }  }'

{  "id": "string",  "name": "string",  "description": "string",  "http_url": "string",  "http_method": "string",  "parameters": {},  "auth_header": "string",  "secret_ref": "string",  "rate_per_min": 0,  "allowed_hosts": [    "string"  ]}