Add trusted caller
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.
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_trusted_caller" \ -H "Content-Type: application/json" \ -d '{ "workspace": "string", "name": "string", "issuer": "http://example.com", "subject": "string", "operations": [ "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 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.
Mark call reviewed POST
Mark a real call as human-reviewed, or un-mark it. Marking stamps you as the reviewer with the current time and saves an optional one-line note; un-marking wipes the reviewer, timestamp, and note so the call reads as honestly unreviewed. Use it to clear a call off the review queue after you've checked it, or to reopen one. The call must be one you can see in this workspace.