Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-15142192531.5 KB

7d1aff84ce3b

Swarms

Get a persona

A persona that lives in a DIFFERENT project answers 404, never 403 — the route is not an existence oracle for a project you cannot see.

get/projects/{projectId}/personas/{personaId}

Response

The persona.

idstring required

Durable id — what journeys reference and what every route here addresses.

projectIdstring required
slugstring required

Stable slug key, shared with exported session data. Useful for correlating transcripts; NOT an address for this API.

namestring required
rolestring required
notesstring nullable required
source'manual' | 'generated' | 'cluster' required

How the persona came to exist.

seedKeywordsstring[]

Present on cluster-derived personas: the terms the cluster was built from.

createdAtnumber required

Epoch milliseconds.

updatedAtnumber required

Epoch milliseconds.