Sign in

List test case definitions for a response engine

get/list-test-case-definitions

Query parameters

type'retell-llm' | 'conversation-flow' required

Type of response engine

llm_idstring

LLM ID (required when type is retell-llm)

conversation_flow_idstring

Conversation flow ID (required when type is conversation-flow)

Response

Test case definitions retrieved successfully

namestring required

Name of the test case definition

user_promptstring required

User prompt to simulate in the test case

metricsstring[] required

Array of metric names to evaluate

dynamic_variablesobject required

Dynamic variables to inject into the response engine

llm_model'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.5' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' required

Available LLM models for agents.

test_case_definition_idstring required

Unique identifier for the test case definition

type'simulation' required

Type of test case definition

creation_timestampinteger required

Timestamp when the test case definition was created (milliseconds since epoch)

user_modified_timestampinteger required

Timestamp when the test case definition was last modified (milliseconds since epoch)

Changes

Changed in 8 of the 28 revisions of this API.73

  • f1a0d7c1e36c1See the full diff
    • ○

      removed the gemini-2.5-flash enum value from the ///// response property for the response status

      response-property-enum-value-removed

  • 1b4a9d84942a11See the full diff
    • ●

      added the new gpt-5.5 enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ○

      endpoint deprecated

      endpoint-deprecated

  • 03728df7863f1See the full diff
    • ●

      deleted the query request parameter version

      request-parameter-removed

  • 8ee53928bf311See the full diff
    • ●

      added the new gemini-3.1-flash-lite enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 3aa6f6e028ef2See the full diff
    • ●

      added the new gpt-5.4-mini enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-5.4-nano enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 424df3aa79001See the full diff
    • ●

      added the new gpt-5.4 enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 8fbf8c54a1421See the full diff
    • ●

      added the new claude-4.6-sonnet enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 9dbbdaf34f4b1See the full diff
    • ○

      endpoint added

      endpoint-added