List replicas
List replicas with pagination with optional filtering. Only Replicas that are public or belong to the authenticated user are returned.
Headers
-
X-API-Version
string Default value is
2025-03-25
.
Query parameters
-
owner_uuid
string Filters by the owner UUID of the Replicas
-
page_index
integer Pagination: The page index to return
Default value is
1
. -
page_size
integer Pagination: The number of items per page
Default value is
24
. -
slug
string Filters by the replica's slug
-
search
string Search: by name of Replica, sorted in ascending order
-
sort
string Sorts by name or popularity of Replicas in ascending order
Values are
name
orpopularity
. Default value isname
. -
integration
string Filters by integration
Values are
telegram
ordiscord
.
GET
/v1/replicas
curl \
--request GET 'https://api.sensay.io/v1/replicas' \
--header "X-ORGANIZATION-SECRET: $API_KEY" \
--header "X-USER-ID: $API_KEY" \
--header "X-API-Version: 2025-03-25"
Response examples (200)
{
"success": true,
"type": "string",
"items": [
{
"name": "Example Replica",
"slug": "copy",
"tags": [
"AI",
"Technology"
],
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2023-10-01T12:00:00Z",
"owner_uuid": "123e4567-e89b-12d3-a456-426614174001",
"introduction": "This is an example replica",
"profile_image": "http://example.com/image.png",
"video_enabled": true,
"voice_enabled": true,
"system_message": "Descriptive, energetic, friendly",
"short_description": "Celebrity",
"chat_history_count": 5,
"discord_integration": {
"token": "MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs",
"is_active": true,
"service_name": "test_discord_bot"
},
"telegram_integration": {
"token": "7701101112:DASeKD32EQLL32113-ngfVUMkyzg",
"service_name": "test_telegram_bot"
}
}
],
"total": 100
}
Response examples (400)
{
"success": true,
"error": "string",
"fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
"request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (401)
{
"success": true,
"error": "string",
"fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
"request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (404)
{
"success": true,
"error": "string",
"request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (415)
{
"success": true,
"error": "string",
"fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
"request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (500)
{
"success": true,
"error": "string",
"fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
"request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab",
"inner_exception": {
"name": "Server overheated",
"cause": "Request too complicated",
"stack": "Error: Server overheated due to an unexpected situation\n at Object.eval (eval at <anonymous>...",
"message": "The server overheated due to an unexpected situation"
}
}