List plugins
List the platform plugins this agent can add, paid third-party capabilities that run on Vertical AI's account rather than the customer's, so there is no API key to obtain or paste. Each row returns { slug, name, vendor, description, toolName, pricePerCallCents, pricePerCall }. Call this before add_plugin_tool so you can tell the operator what exists and what each call costs, and prefer a plugin over hand-building an HTTP tool against the same vendor: a hand-built one needs a key stored as a secret variable and reproduces none of the tuned error handling. Price is per call, charged to the workspace and itemised on its bill.
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.
Target agent as 'workspace-slug/agent-slug' (e.g. 'luke/support-bot').
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/list_plugins" \ -H "Content-Type: application/json" \ -d '{ "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
}List personas POST
List every caller persona in this workspace's catalogue (predefined + custom) with its slug, name, type (predefined/custom), gender, language, and whether it's enabled. A persona is a SIMULATED CALLER a test scenario runs as, tone, behaviour, voice, accent, interruption, workspace-scoped and reusable across agents. Call this FIRST to resolve a persona before referencing one in a scenario, and before create_persona so you don't duplicate a persona the catalogue already ships. Predefined personas can't be edited or deleted but can be forked into an editable custom copy.
List publishable keys POST
List the agent's active publishable keys (pk_live_/pk_test_) for the embeddable website chat widget. Returns each key's id, label, environment, prefix (never the full key, only the prefix is stored), the origin allowlist that drives the embed CORS, and last-used time. Use before create_publishable_key to avoid minting duplicates, or to get an id for revoke_publishable_key.