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"
  }
}

Changes

Changed in 2 of the 29 revisions of this API.13

Dec 10, 20255a9a6b9cb07a12See the full diff
- ○
  added the optional property details to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property details to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property details to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property details to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property request_id to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property request_id to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property request_id to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property request_id to the response with the 500 status
  response-optional-property-added
- ○
  added the required property error_code to the response with the 400 status
  response-required-property-added
- ○
  added the required property error_code to the response with the 401 status
  response-required-property-added
- ○
  added the required property error_code to the response with the 422 status
  response-required-property-added
- ○
  added the required property error_code to the response with the 500 status
  response-required-property-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 17, 202593aa65273d4d1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history