Create a persona

Create a custom persona for the authenticated user.

POST

https://truememory-api.mvstg.com/personas

View as Markdown

Authorization

HTTPBearerHTTPrequired

Header parameters

X-On-Behalf-Ofoptional
One of the following:
string
null
}
X-External-User-Idoptional
One of the following:
string
null
}
X-App-Idoptional
One of the following:
string
null
}

Request bodyJSONrequired

namestringrequired
Display name for the persona.

maxLength: 255 · minLength: 1
system_promptstringrequired
System prompt injected at the start of every conversation when this persona is active.

minLength: 1
descriptionoptional
Short human-readable description of the persona's purpose.
One of the following:
string
null
}
visibilityoptionalprivateorpublic
private = creator only; public = available to users in every app.

default: "private"
archetypeoptional
App-defined archetype identifier (e.g. SAGE, EXPLORER). Shared across apps.
One of the following:
string
null
}
soul_documentoptional
Structured personality document (JSON). Keys: voiceAndStyle, antiPatterns, learnedAdaptations, boundaries, customInstructions.
One of the following:
object
null
}
human_profileoptional
Creator-specific profile data. Never shared with public persona consumers.
One of the following:
string
null
}
avataroptional
URL of the persona's avatar image.
One of the following:
string
null
}
avatar_configoptional
App-defined dynamic avatar settings (a JSON object, 64 KB max). Truememory stores and returns it unchanged and never puts it in a prompt.
One of the following:
object
null
}

Returns

201

Successful Response

JSON

idstringrequired
user_idrequired
Owner user_id, NULL for presets.
One of the following:
string
null
}
namestringrequired
descriptionrequired
One of the following:
string
null
}
system_promptstringrequired
is_presetbooleanrequired
created_atstringrequired
format: date-time
updated_atstringrequired
format: date-time
visibilityoptionalprivateorpublic
default: "private"
is_activeoptionalboolean
default: false
archetypeoptional
App-defined archetype identifier (e.g. SAGE, EXPLORER). Each app renders its own visual for this.
One of the following:
string
null
}
soul_documentoptional
Structured personality document: voice style, anti-patterns, learned adaptations, boundaries, custom instructions.
One of the following:
object
null
}
human_profileoptional
Creator-specific profile data. Hidden from other users when the persona is public.
One of the following:
string
null
}
avataroptional
URL of the persona's avatar image.
One of the following:
string
null
}
avatar_configoptional
App-defined dynamic avatar settings (a JSON object, 64 KB max). Truememory stores and returns it unchanged and never puts it in a prompt.
One of the following:
object
null
}

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}

curl --request POST \ --url https://truememory-api.mvstg.com/personas \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Friendly Coach", "description": "A warm, encouraging coaching persona", "system_prompt": "You are a friendly life coach. Respond with empathy and encouragement.", "visibility": "private", "archetype": "string", "soul_document": {}, "human_profile": "string", "avatar": "string", "avatar_config": {} } '

{ "id": "string", "user_id": "string", "name": "string", "description": "string", "system_prompt": "string", "is_preset": true, "visibility": "private", "is_active": false, "archetype": "string", "soul_document": {}, "human_profile": "string", "avatar": "string", "avatar_config": {}, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }