List personas

List available personas (presets + user's custom) with is_active flag.

GET

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
}

Returns

200

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
}

[ { "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" } ]