Sign in
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

Changes

Changed in 11 of the 26 revisions of this API.1321

  • 1e014c365df211See the full diff
    • ●

      removed the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/user from the response with the 200 status

      response-optional-property-removed

    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/source to the response with the 200 status

      response-optional-property-added

  • 5b77ae7cc5c41See the full diff
    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/creator/anyOf[subschema #1: User]/user_photo to the response with the 200 status

      response-optional-property-added

  • b2372bf7485c2See the full diff
    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/creator/anyOf[subschema #1: User]/actions to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/energy_points to the response with the 200 status

      response-optional-property-added

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 3aaae7d83feb1See the full diff
    • ○

      added the new enum value energy_points to the query request parameter sort

      request-parameter-enum-value-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 05cf5f034c745See the full diff
    • ○

      api tag android_app added

      api-tag-added

    • ○

      api tag evaluation added

      api-tag-added

    • ○

      api tag web_app added

      api-tag-added

    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/background_animated to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/version to the response with the 200 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

  • bd9470194fe11See the full diff
    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/user to the response with the 200 status

      response-optional-property-added

  • d681a7df36092See the full diff
    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/avatar_size to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/background_size to the response with the 200 status

      response-optional-property-added

  • 7ee2ad97db782See the full diff
    • ○

      added the new enum value score_based_random to the query request parameter sort

      request-parameter-enum-value-added

    • ○

      added the optional property data/anyOf[subschema #1: PaginationData[Agent]]/list/items/meta_data to the response with the 200 status

      response-optional-property-added

  • 05767e62959c121See the full diff
    • ▲

      removed the request body

      request-body-removed

    • ●

      deleted the query request parameter count

      request-parameter-removed

    • ●

      deleted the query request parameter index

      request-parameter-removed

    • ○

      added the new optional query request parameter sort_seed

      new-optional-request-parameter

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6176ea0e91293See the full diff
    • ○

      added the new optional query request parameter count

      new-optional-request-parameter

    • ○

      added the new optional query request parameter index

      new-optional-request-parameter

    • ○

      added optional request body

      request-body-added-optional