Swarms

Update a persona

Changed on

Partial update. Goals reference the persona by id, so renaming one does not disturb anything pointing at it.

patch/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

Request body

namestring

1–120 characters.

rolestring

What this person is, in the product's terms — "finance ops lead", "first-time buyer". 1–120 characters.

notesstring

Free-text context the model is grounded in. Up to 2000 characters.

avatarShapeinteger

Index into the app's fixed shape set. Out of range is a 400 naming the field, not an upstream error about a constant you have never seen.

avatarPaletteinteger

Index into the app's fixed palette set.

Response

The updated 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