v26

latestOpenAPI 3.1.0raw.githubusercontent.com2026-01-285194311.8 KB
agents
characters
android_app
web_app
evaluation

Get recommended AI agents list

Get recommended AI agents list (public and approved agents), sort_seed is required when sort is random, which is used to ensure deterministic order for the random sort option

get/api/v1/ai/agents/recommend

Query parameters

pageinteger

Page number, starting from 1

Page number, starting from 1

page_sizeinteger

Items per page, maximum 100

Items per page, maximum 100

sort'created_asc' | 'created_desc' | 'random' | 'score_based_random' | 'energy_points'

Agent sorting options

Sort order: created_asc, created_desc, random, score_based_random, energy_points

sort_seedstring

Sort seed for deterministic random ordering

Sort seed for deterministic random ordering

Response

Successful Response

codeinteger
messagestring