List Models

Retrieves a list of all available AI models that can be used for background agents. This helps you choose the most appropriate model for your task based on capabilities and requirements.

Overview

• Purpose: Get a list of all AI models available for use with background agents.
• Use Cases: Selecting the right model for your task, discovering new models, validating model names before launching agents.
• API Method: GET /v0/models

Input Fields

No Input Required: This action does not require any input parameters. It returns all available models.

Output

Models Array: A list of model identifiers (strings) that can be used in the ‘Launch Agent’ action.

Each model identifier can be passed to the ‘model’ field when creating a new agent.

Model Selection Considerations

• Task Complexity: Different models may have different capabilities. More advanced models may be better for complex refactoring or architectural changes.
• Performance: Some models may be faster but less capable, while others are more thorough but slower.
• Default Behavior: If you don’t specify a model when launching an agent, Cursor will select an appropriate default model.
• Availability: Model availability may change over time as new models are added or deprecated.

Tips

[!TIP] Call this action before launching agents to see the latest available models

[!TIP] Use the returned model identifiers exactly as provided in the ‘Launch Agent’ action

[!TIP] Experiment with different models to find the best fit for your specific use cases

[!TIP] Keep model lists updated in your workflow configurations

[!TIP] Consider caching the model list to reduce API calls, but refresh periodically