Skip to main content
POST
Generate GEO personas

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.

Path Parameters

projectId
string
required
Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$
Example:

"b1f2c3d4-0000-4000-8000-000000000000"

Body

application/json
personaId
string

Regenerate this persona in place instead of creating a new set.

Minimum string length: 1
brief
string

Describe one persona to add, such as 'a CFO at a 200-person logistics company'.

Required string length: 1 - 2000
promptsOnly
enum<boolean>

With personaId, only rewrite its conversation prompts and keep its details.

Available options:
true

Response

Generation job queued or already running

job
object | null
required

The project's latest generation job, or null when none ran recently.

organization
object
required