CircleCI

CircleCI

CircleCI is a CI/CD platform for pipelines, workflows, and jobs. Org → project → workflow → job hierarchy.

Typical read order

1. Discover defaults — resolve owner_slug, org_slug, project_slug, workflow_id, and job_number for your account.
2. Collaborations or pipelines — confirm org access and pick a project_slug when defaults are unset.
3. Project-scoped reads — insights branches, metrics summary, project metadata, job detail.
4. Workflow-scoped reads — workflow status, then jobs in that workflow.

Data model

• Pipelines and projects are org-scoped. Workflows belong to pipelines. Jobs belong to workflows.
• Insights branch lists and metrics summaries are keyed by project_slug. Contexts (shared env vars) are keyed by owner_slug.
• Hierarchy: org_slug → project_slug → workflow_id → job_number. Connection defaults on the credential reduce repeated slug params.

Gotchas

• Slug format: owner_slug and org_slug often look like circleci/<org_id>. project_slug is circleci/<org>/<project>.
• v1.1 projects embed branch → latest_workflows maps; useful when you have a project but not a pipeline id yet.
• Connection defaults: save owner_slug, org_slug, and project_slug on the CircleCI credential when you reuse the same org/project.