Personas
Personas define user archetypes that agents can embody. The persona description is injected verbatim into the agent's LLM system prompt, directly shaping how the agent interacts with the target site.
System Prompt Injection
The persona's description field is injected verbatim into the agent's LLM system prompt. This means the description directly controls the agent's behavior — write it as instructions the model should follow, not as a narrative for humans.
For example, a description like "You are an impatient power user who uses keyboard shortcuts and skips optional steps" will cause the agent to navigate faster and avoid filling optional fields.
Paste your API key to use the Try it panels below. Don't have one? Create an account.
POST
/api/v1/personas Create a new persona| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
name | string | body | Yes | Persona name |
description | string | body | No | Behavioral description for the persona |
cURL
Response
GET
/api/v1/personas List personas| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
limit | integer | query | No | Number of results to return (default: 20) |
cursor | uuid | query | No | Cursor for pagination |
cURL
Response
GET
/api/v1/personas/{id} Get persona by ID| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
id | uuid | path | Yes | Persona ID |
cURL
Response
DELETE
/api/v1/personas/{id} Delete a persona| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
id | uuid | path | Yes | Persona ID |
cURL
Response