CEcekura
test_framework

List evaluators

Changed on

scenarios_list: List evaluators (test scenarios) that simulate callers interacting with your agent. Filter by agent_id, project_id, tags, folder_path, or other params (see Schema). Returns paginated scenarios with their instructions, type, personalities, and metrics.

Performance tip: pass the most specific filter you have. agent_id if a specific agent is in context, folder_path if you're discussing a specific folder, or project_id for a workspace-level view. page_size=20 is a reasonable starting size if you want to peek at recent ones first.

get/test_framework/v1/scenarios/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/test_framework/v1/scenarios/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

agent_idinteger

Filter evaluators by agent ID Example: 2142

project_idinteger

Filter evaluators by project ID Example: 1

assistant_idstring

Filter evaluators by assistant ID Example: asst_1234567890

tagsstring

Comma-separated list of tags to filter evaluators by Example: tag1,tag2,tag3

tag_filter_type'and' | 'or' | 'not'

Filter operation type for tags

  • and - and
  • or - or
  • not - not
folder_pathstring

Filter evaluators by folder path. Use empty string to get evaluators without a folder. Example: Sales.Inbound

orderingstring

Sort evaluators by a field. Prefix with - for descending. Defaults to newest first. Allowed: id, name, created_at, updated_at, personality_name, agent_name, test_profile_name, scenario_language Example: -updated_at

conditional_actions_format'legacy'

Set to legacy to return conditional-action instructions in the earlier id-based format (id, condition, action, type, fixed_message).

  • legacy - legacy

Response

countinteger required
nextstring uri nullable
previousstring uri nullable

Example response

{
  "count": 123,
  "next": "https://api.cekura.ai/example/v1/example-external/?page=4",
  "previous": "https://api.cekura.ai/example/v1/example-external/?page=3"
}

Changes