Agents

Get a tool

get/v1/tools/{id}

Request

  • Base URL: https://api.pyai.com
  • URL: https://api.pyai.com/v1/tools/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

Response

Tool

objectstring
idstring
org_idstring nullable
namestring
kind'prebuilt' | 'custom'
descriptionstring
input_schemaobject
webhook_urlstring nullable
execution'hosted' | 'server' | 'engine' | 'client'

How the tool runs. hosted = PyAI runs it (prebuilt read catalog). server = the tool-executor calls your webhook. engine = the Omni call engine runs it natively (call control: transfer_to_human, send_dtmf, play_hold, collect, end_call), not routed to the executor. client = your connected app.

auth_headerstring nullable
has_authboolean

Whether a webhook auth secret is configured (the secret itself is never returned).

side_effect'read' | 'action'
timeout_msinteger
status'active' | 'disabled'
created_atinteger

Example response

{
  "object": "tool"
}

Changes

No recorded changes to this operation across all 1 revision of this API.