Create agent tool - Sendora

POST

/

api

/

v1

/

public

/

voice-agents

/

{agent_id}

/

tools

cURL

curl -X POST 'https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools' -H "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind":"example"}'

import requests

url = 'https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools'
headers = {'X-API-Key': '$SENDORA_API_KEY'}
response = requests.post(url, headers=headers, json={'kind': 'example'})
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools", {
  method: "POST",
  headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({"kind": "example"}),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

req, err := http.NewRequest("POST", "https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools", bytes.NewBufferString(`{"kind": "example"}`))
if err != nil { log.Fatal(err) }
req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Customer API key created in the Sendora dashboard.

Headers

X-API-Key

string | null

Authorization

string | null

Path Parameters

agent_id

string

required

The voice agent's id: the id from List voice agents. It is also the last part of that page's address in the app.

Body

application/json

kind

string

required

builtin | sendora_http | custom_http

agent_end_behavior

string | null

Agent end behavior returned by the Sendora API.

auth_tokens

Auth Tokens · object[] | null

Auth tokens returned by the Sendora API.

automatic_parameters

Automatic Parameters · object[] | null

Automatic parameters returned by the Sendora API.

builtin_tool_name

string | null

Builtin tool name returned by the Sendora API.

config

Config · object | null

Config returned by the Sendora API.

description

string | null

Description returned by the Sendora API.

display_name

string | null

Display name returned by the Sendora API.

dynamic_parameters

Dynamic Parameters · object[] | null

Dynamic parameters returned by the Sendora API.

http_method

string | null

Http method returned by the Sendora API.

http_url

string | null

Http url returned by the Sendora API.

name

string | null

Name returned by the Sendora API.

static_parameters

Static Parameters · object[] | null

Static parameters returned by the Sendora API.

static_response_enabled

boolean | null

Static response enabled returned by the Sendora API.

static_response_message

string | null

Static response message returned by the Sendora API.

timeout_seconds

number | null

Timeout seconds returned by the Sendora API.

Response

Successful Response

The response is of type Response Create Agent Tool Api V1 Public Voice Agents Agent Id Tools Post · object.

cURL

curl -X POST 'https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools' -H "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind":"example"}'

import requests

url = 'https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools'
headers = {'X-API-Key': '$SENDORA_API_KEY'}
response = requests.post(url, headers=headers, json={'kind': 'example'})
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools", {
  method: "POST",
  headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({"kind": "example"}),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

req, err := http.NewRequest("POST", "https://api.sendora.ai/api/v1/public/voice-agents/YOUR_ID/tools", bytes.NewBufferString(`{"kind": "example"}`))
if err != nil { log.Fatal(err) }
req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}