# CircleCI API for AI Agents

Connect the CircleCI API to your AI agent through Swytchcode. Call the CircleCI API from the agent stack you already run. Swytchcode supplies the manifest, then handles authentication, retries, idempotency, and validation on every call.

## What can you build with the CircleCI API?

1. Call CircleCI directly from an AI agent without writing custom auth, retry, or error-handling code.
2. Get the right endpoints and call sequence for the workflow you need, instead of having the agent explore the CircleCI API surface.
3. Chain CircleCI with other approved integrations in one workflow, each step validated against your policy before it runs.
4. Give an agent safe read/write access to CircleCI in production, with idempotent retries if a call fails.

## How to connect the CircleCI API to an AI agent

Four steps, no SDK, no boilerplate. Every CircleCI call routed through Swytchcode is idempotency-keyed and safe to retry.

1. **Install the CLI**  
   Run "npx swytchcode" to install the Swytchcode CLI—no account required to start.
2. **Pull the manifest**  
   Run "swytchcode get circleci" to pull the CircleCI API manifest, including its schema and available actions.
3. **Authenticate once**  
   Provide your CircleCI API credentials a single time. Swytchcode stores and refreshes them so your agent never handles raw secrets.
4. **Call it from your agent**  
   Run "swytchcode exec circleci.<action> --key value" from any agent or script. No SDK, no framework lock-in.

### Example Commands
```
swytchcode get circleci
swytchcode exec circleci.<action> --key value
```

## Frequently asked questions

### What is Swytchcode?

### How do I get started with Swytchcode?

### How does an AI agent actually call the CircleCI API through Swytchcode?

### What happens if a CircleCI call fails, times out, or hits a rate limit?

### Can I restrict which CircleCI actions my agent is allowed to run?

### Where does Swytchcode store my CircleCI credentials?

### Do I need to write a custom CircleCI SDK integration for my agent?

### How is calling CircleCI through Swytchcode different from calling its API directly?

### Do I need a specific framework to call CircleCI?

### Does Swytchcode log what my agent does with CircleCI?