curl --request POST \
  --url https://voice-api.onclarity.com/v1/projects/{projectId}/tools \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "lookup_order",
  "description": "Look up an order by its number and return its status.",
  "type": "http",
  "configs": {
    "url": "https://api.example.com/orders",
    "method": "GET",
    "query_params": [
      {
        "name": "number",
        "value": "{{order_number}}"
      }
    ],
    "authentication": {
      "type": "bearer",
      "token": "vault:orders_api_token"
    }
  },
  "parameters": {
    "type": "object",
    "required": [
      "order_number"
    ],
    "properties": {
      "order_number": {
        "type": "string",
        "description": "The order number the caller reads out."
      }
    }
  },
  "hold_message": "One moment while I check that order."
}
'

import requests

url = "https://voice-api.onclarity.com/v1/projects/{projectId}/tools"

payload = {
    "name": "lookup_order",
    "description": "Look up an order by its number and return its status.",
    "type": "http",
    "configs": {
        "url": "https://api.example.com/orders",
        "method": "GET",
        "query_params": [
            {
                "name": "number",
                "value": "{{order_number}}"
            }
        ],
        "authentication": {
            "type": "bearer",
            "token": "vault:orders_api_token"
        }
    },
    "parameters": {
        "type": "object",
        "required": ["order_number"],
        "properties": { "order_number": {
                "type": "string",
                "description": "The order number the caller reads out."
            } }
    },
    "hold_message": "One moment while I check that order."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'lookup_order',
    description: 'Look up an order by its number and return its status.',
    type: 'http',
    configs: {
      url: 'https://api.example.com/orders',
      method: 'GET',
      query_params: [{name: 'number', value: '{{order_number}}'}],
      authentication: {type: 'bearer', token: 'vault:orders_api_token'}
    },
    parameters: {
      type: 'object',
      required: ['order_number'],
      properties: {
        order_number: {type: 'string', description: 'The order number the caller reads out.'}
      }
    },
    hold_message: 'One moment while I check that order.'
  })
};

fetch('https://voice-api.onclarity.com/v1/projects/{projectId}/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "6e2a4c8d-1b3f-4a5c-9d7e-0f1a2b3c4d5e",
  "project_id": "3f6c1a52-8d0e-4b8f-9a51-2c7d4e0b9f13",
  "agent_id": null,
  "name": "lookup_order",
  "description": "Look up an order by its number and return its status.",
  "type": "http",
  "configs": {
    "url": "https://api.example.com/orders",
    "method": "GET",
    "query_params": [
      {
        "name": "number",
        "value": "{{order_number}}"
      }
    ],
    "authentication": {
      "type": "bearer",
      "token": "vault:orders_api_token"
    }
  },
  "parameters": {
    "type": "object",
    "required": [
      "order_number"
    ],
    "properties": {
      "order_number": {
        "type": "string",
        "description": "The order number the caller reads out."
      }
    }
  },
  "parameter_mapping": null,
  "hold_message": "One moment while I check that order.",
  "hold_messages": null,
  "async_config": null,
  "session": null,
  "updated_at": 1794393600000,
  "library_tool_id": null,
  "library_revision": null,
  "library_channels": null
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "Invalid or revoked token"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "tool_name_already_exists_for_agent",
  "project_id": "3f6c1a52-8d0e-4b8f-9a51-2c7d4e0b9f13",
  "agent_id": null,
  "name": "lookup_order",
  "hint": "A project-global tool with this name already exists."
}

{
  "error": "configs: For type http, configs.url is required (a non-empty string)",
  "issues": [
    {
      "path": "configs",
      "code": "custom",
      "message": "For type http, configs.url is required (a non-empty string)"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>"
}