Sign in

v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 personas

Create a new persona

Create a new persona for the authenticated user.

This endpoint:
- Creates a new persona with the provided name and description
- Associates the persona with the authenticated user
- Returns the created persona with all metadata

**Authentication**: Requires valid API key or JWT token
post/v1/personas

Request body

namestring required

Persona name

descriptionstring nullable

Optional persona description

Example request

{
  "description": "A persona specialized in creative writing and storytelling",
  "name": "Creative Writer"
}

Response

Successful Response

messagestring required

Success message

Example response

{
  "message": "Persona created successfully",
  "persona": {
    "created_at": "2023-01-01T00:00:00Z",
    "description": "A persona specialized in creative writing",
    "name": "Creative Writer",
    "persona_id": "123e4567-e89b-12d3-a456-426614174000",
    "user_email": "john@example.com",
    "user_id": "456e7890-e89b-12d3-a456-426614174001",
    "user_name": "John Doe"
  }
}