Skip to Content
Cut.ProDocs
AI characters

List personas

Returns the workspace's personas, newest first, drafts included. image_status and video_generating say what is still being generated, so one call shows every persona in progress.

Authorization

apiKey
headerX-Api-Key<token>

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 20, max: 100)

Range1 <= value <= 100

Response Body

Response for status 200

application/json
  1. response
personas*array<>
pagination*
GET
/personas
Example Request
curl -X GET 'https://api.cut.pro/api/v1/personas'
Example Response200
{  "personas": [    {      "id": "string",      "name": "string",      "status": "draft",      "image_status": "generating",      "video_generating": true,      "face_url": "string",      "created_at": "string"    }  ],  "pagination": {    "current_page": 0,    "total_pages": 0,    "total_count": 0,    "has_next_page": true,    "has_previous_page": true,    "limit": 0  }}