Add tool from website
Add ONE live website lookup tool that reads a business website during a call. Describe the tool you want in plain English. To add it to a site already connected to the agent, pass `connectionId` (or omit it when there's exactly one connected site), a matching endpoint is reused for free, or the site's recipe is extended. To connect a NEW site first, pass `siteUrl` (owner-only). Unlike the onboarding build, this mints just the one tool you describe, not the whole catalogue.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/add_tool_from_website" \ -H "Content-Type: application/json" \ -d '{ "intent": "string", "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Add site lookup POST
Add a live website lookup tool that reads the business's own website during a call. Describe in plain English what the agent should look up; the right endpoint for the site is authored automatically and wired as an HTTP tool. Pass `siteUrl` only the first time (when the agent has no connected website yet), after that it reuses the connected site.
Add trusted caller POST
Let a server call the REST API for this workspace with a short-lived OpenID Connect token its host signs, so it holds no access token. The server sends that token as Authorization: Bearer, asked for with the API's origin as its audience (for example https://app.verticalai.com.au). A request is accepted when the token's signature checks out against the issuer's published keys, its issuer and subject equal the ones given here, every requiredClaims value matches, and the operation is listed in operations. It then runs as you, pinned to this workspace. Only supported issuers are accepted (unsupported_issuer otherwise), and some issuers need stable ids pinned in requiredClaims, which the refusal names. One issuer and subject can be trusted by one workspace. Remove it with remove_trusted_caller. Needs owner or admin.