Swarms

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}

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/personas/{personaId}
  • Auth
    HTTP bearer

Response

The persona.

idstring required

Durable id — what goals 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.

Changes