/
AS
astrbotdevs
/
AstrBot OpenAPI v1
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 1h ago · Updated 1w ago
View markdown
astrbotdevs
AstrBot OpenAPI v1
post
Create a persona
v12
latest
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-02
232
57
199.4 KB
Bot Config Routes
4
Bots
15
Chat
28
Config Profiles
7
Conversations
7
Files
5
IM
2
MCP
11
Open API
2
Personas
15
get
Get persona folder tree
get
List personas
post
Create a persona
get
Get a persona by query ID
put
Update a persona by body ID
delete
Delete a persona by query ID
get
Get a persona
put
Update a persona
delete
Delete a persona
get
List persona folders
post
Create a persona folder
put
Update a persona folder
delete
Delete a persona folder
post
Move a persona or folder
post
Reorder personas or folders
Plugin Pages
12
Plugin Sources
5
Plugins
40
Provider Sources
10
Providers
19
Sessions
11
Skills
24
Subagents
3
System Config
4
T2I
8
Personas
Create a persona
Required scope:
persona
post
/api/v1/personas
Request body
PersonaRequest
required
persona_id
string
required
system_prompt
string
required
begin_dialogs
string[]
folder_id
string
tools
string[]
skills
string[]
custom_error_message
string
Response
Standard AstrBot success response
SuccessEnvelope
required
status
'ok'
required
message
string
{"stackTrail":"components:schemas:SuccessEnvelope:properties:data","oasType":"schema","type":"unknown"}