List personas
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.
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_personas" \ -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 partner payouts POST
List a partner workspace's payouts, each with amount, status (pending/approved/paid/…), method, and timestamps. Payouts are swept monthly once accrued commission clears the minimum threshold.
List plugins POST
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.