Update a persona

Update a custom (non-preset) persona owned by the authenticated user.

PUT

https://truememory-api.mvstg.com/personas/{persona_id}

View as Markdown

Authorization

HTTPBearerHTTPrequired

Path parameters

persona_idstringrequired

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

nameoptional
New display name for the persona.
One of the following:
string
null
}
descriptionoptional
Updated description of the persona's purpose. Pass null to clear.
One of the following:
string
null
}
system_promptoptional
Updated system prompt.
One of the following:
string
null
}
visibilityoptional
Updated platform-wide visibility.
One of the following:
string
null
}
archetypeoptional
Updated archetype identifier. Pass null to clear.
One of the following:
string
null
}
soul_documentoptional
Updated structured personality document. Pass null to clear.
One of the following:
object
null
}
human_profileoptional
Updated user profile text. Pass null to clear.
One of the following:
string
null
}
avataroptional
Updated avatar URL. Pass null to clear.
One of the following:
string
null
}
avatar_configoptional
Replaces the whole avatar config (no merge). Pass null to clear.
One of the following:
object
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
}

curl --request PUT \ --url 'https://truememory-api.mvstg.com/personas/<persona_id>' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Strict Mentor", "description": "A direct, no-nonsense mentoring persona", "system_prompt": "You are a strict mentor. Be concise and direct.", "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" }