Skip to main content
POST
Create tool

Authorizations

Authorization
string
header
required

Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.

Body

application/json
tool_provider_id
string<uuid>
required
Example:

"8d3b1a75-6c02-4e59-b84f-27a9d5e10c63"

name
string
required
Minimum string length: 1
Example:

"Get customer"

path
string
required
Minimum string length: 1
Example:

"/customers/{customerId}"

description
string | null
Example:

"Fetches one customer by id"

method
enum<string>
default:GET
Available options:
GET,
POST,
PUT,
PATCH,
DELETE
input_schema
object | null
Example:
output_schema
object | null
Example:
timeout_ms
integer
Required range: 1000 <= x <= 120000
Example:

30000

is_enabled
boolean
Example:

true

operation_id
string
Example:

"getCustomer"

tags
string[] | null
Example:
deprecated
boolean
Example:

false

Response

The saved tool, and what rebuilding the agents that use it did

tool
object
rebuild
object