# CircleCI

Manage CircleCI: pipelines, workflows, jobs, contexts, schedules, insights. Exposes **37 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `circleci_me` | Get authenticated user profile - GET /me. |
| `circleci_projects_list` | List projects - GET /projects. |
| `circleci_project_get` | Get one project - GET /project/{project_slug}. |
| `circleci_project_create` | Create a new project - POST /project. |
| `circleci_pipelines_list` | List pipelines for a project - GET /project/{project_slug}/pipeline. |
| `circleci_pipeline_get` | Get one pipeline - GET /pipeline/{pipeline_id}. |
| `circleci_pipeline_trigger` | Trigger a new pipeline - POST /project/{project_slug}/pipeline. |
| `circleci_workflow_get` | Get one workflow - GET /workflow/{workflow_id}. |
| `circleci_workflow_cancel` | Cancel a workflow - POST /workflow/{workflow_id}/cancel. |
| `circleci_workflow_rerun` | Rerun a workflow - POST /workflow/{workflow_id}/rerun. |
| `circleci_workflow_jobs_list` | List jobs in a workflow - GET /workflow/{workflow_id}/job. |
| `circleci_job_get` | Get one job details - GET /job/{job_id}. |
| `circleci_job_cancel` | Cancel a job - POST /job/{job_id}/cancel. |
| `circleci_job_artifacts_list` | List artifacts for a job - GET /job/{job_id}/artifacts. |
| `circleci_job_logs` | Get job logs - GET /job/{job_id}/log. |
| `circleci_job_tests` | Get job test results - GET /job/{job_id}/tests. |
| `circleci_checkout_keys_list` | List checkout (deploy) keys for a project - GET /project/{project_slug}/checkout-key. |
| `circleci_checkout_key_get` | Get one checkout key - GET /project/{project_slug}/checkout-key/{fingerprint}. |
| `circleci_checkout_key_create` | Create a new checkout key - POST /project/{project_slug}/checkout-key. |
| `circleci_checkout_key_delete` | Delete a checkout key - DELETE /project/{project_slug}/checkout-key/{fingerprint}. |
| `circleci_env_vars_list` | List environment variables for a project - GET /project/{project_slug}/envvar. |
| `circleci_env_var_get` | Get one environment variable - GET /project/{project_slug}/envvar/{name}. |
| `circleci_env_var_create` | Create an environment variable - POST /project/{project_slug}/envvar. |
| `circleci_env_var_delete` | Delete an environment variable - DELETE /project/{project_slug}/envvar/{name}. |
| `circleci_contexts_list` | List contexts for an organization - GET /context. |
| `circleci_context_get` | Get one context - GET /context/{context_id}. |
| `circleci_context_create` | Create a new context - POST /context. |
| `circleci_context_delete` | Delete a context - DELETE /context/{context_id}. |
| `circleci_context_variables_list` | List environment variables in a context - GET /context/{context_id}/environment-variable. |
| `circleci_context_variable_create` | Create an environment variable in a context - POST /context/{context_id}/environment-variable. |
| `circleci_context_variable_delete` | Delete an environment variable from a context - DELETE /context/{context_id}/environment-variable/{name}. |
| `circleci_schedules_list` | List scheduled pipelines for a project - GET /project/{project_slug}/schedule. |
| `circleci_schedule_get` | Get one schedule - GET /schedule/{schedule_id}. |
| `circleci_schedule_create` | Create a new scheduled pipeline - POST /project/{project_slug}/schedule. |
| `circleci_schedule_delete` | Delete a schedule - DELETE /schedule/{schedule_id}. |
| `circleci_insights_metrics` | Get workflow metrics (insights) for a project - GET /project/{project_slug}/insights/metrics. |
| `circleci_insights_tests` | Get test metrics (insights) for a project - GET /project/{project_slug}/insights/tests. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`CIRCLECI_API_TOKEN`** - CircleCI - User Settings - Personal API Tokens. (https://app.circleci.com/settings/user/tokens)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `CIRCLECI_API_TOKEN` | CircleCI - User Settings - Personal API Tokens. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [CircleCI API documentation](https://circleci.com/docs/api/v2/)