Overview
Programmatically create and manage background agents that work on your repositories
Background Agents API
The Background Agents API allows you to programmatically create and manage AI-powered coding agents that work autonomously on your repositories. You can use the API to automatically respond to user feedback, fix bugs, update docs, and much more!Background Agents API is currently in beta, we’d love your feedback on it!
Key features
- Autonomous code generation - Create agents that can understand your prompt and make changes to your codebase
- Repository integration - Work directly with GitHub repositories
- Follow-up prompts - Add additional instructions to running agents
- Usage-based pricing - Pay only for the tokens you use
- Scalable - Support for up to 256 active agents per API key
Quick start
1. Get your API key
Navigate to Cursor Dashboard → Integrations to create your API key.2. Start using the API
All API endpoints are relative to:Authentication
All API requests require authentication using a Bearer token:Pricing
The API is currently in beta with the same pricing as Background Agents. Pricing may change as we scale the service. See Background Agent pricing.Next steps
- Read the main Background Agents overview to understand environments, permissions, and workflows.
- Try Background Agents from web & mobile.
- Join the discussion in Discord #background-agent or email background-agent-feedback@cursor.com.