Skip to main content
PUT
Bind tools to an agent

Authorizations

Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Path Parameters

id
string
required

Body

application/json
tool_id
string
required
enabled
boolean
default:true
config
object

Customer SETTINGS for this tool on this agent, keyed by the tool's config_schema field keys (e.g. { from_number, provider_api_key }). Fields marked secret are encrypted at rest and returned masked ('********'); re-send the mask (or omit) to keep the stored value.

name
string

Present on agent reads when the tool resolves.

description
string
input_schema
object

Per-call model argument schema. Present on agent reads when the tool resolves.

execution
enum<string>

Resolved execution mode. Present on agent reads when the tool resolves.

Available options:
hosted,
server,
engine,
client

Response

Updated bindings

object
string
Example:

"list"

data
object[]