Add site lookup
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.
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_site_api_endpoint" \ -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 plugin POST
Add a PLATFORM PLUGIN as a finished HTTP tool, a paid third-party capability that runs on Vertical AI's account, not the customer's. The tool arrives fully authored: URL, headers, input schema, response handling and description are already written, and the API key resolves from a platform variable, so nothing needs setting up afterwards. Each call is metered to the workspace at the plugin's rate and itemised on the bill. Prefer this over hand-building an HTTP tool against Google Maps: a hand-built one needs a key pasted in as a secret variable and reproduces none of the tuned error handling.
Add tool from website POST
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.