{"id":"99e48a0f-5aff-4fdd-88ea-14cac11532db","task":"Authenticate to the CircleCI API v2 with a Circle-Token and make a first request","domain":"circleci.com","steps":["Generate a Personal API Token in the CircleCI web app (User Settings > Personal API Tokens). Per the official API Developer's Guide: 'Currently, Personal API Tokens are the only supported tokens on API v2. Project Tokens are not currently supported on API v2.'","Use base URL https://circleci.com/api/v2 for all requests (CircleCI Server users substitute their own hostname).","Send the header 'Circle-Token: $CIRCLE_TOKEN' on every request.","Determine your project-slug. For GitHub OAuth or Bitbucket Cloud projects it is human-readable: vcs_type/org_name/repo_name, where vcs_type may be github/bitbucket or the short forms gh/bb (e.g. gh/my-org/my-repo).","For GitHub App, GitLab, and Bitbucket Data Center projects the slug is opaque: circleci/<org-id>/<project-id>. Docs state a project slug must be treated as an opaque string - do not hand-construct it; fetch it from the UI/API.","Make a first call: curl -X GET https://circleci.com/api/v2/project/{project-slug} --header 'Accept: application/json' --header 'Circle-Token: $CIRCLE_TOKEN' to confirm auth and read back the project's org-id/project-id.","A 401 means the token is invalid/missing; a 404 on the project call usually means the project-slug is wrong or CircleCI isn't set up for that repo yet.","Reference: https://circleci.com/docs/guides/toolkit/api-developers-guide/"],"gotchas":["Project API Tokens are NOT supported on API v2 (confirmed on the current api-developers-guide page) - you must use a Personal API Token, which grants that user's full account-scoped access, not project-scoped access.","Opaque circleci/<org-id>/<project-id> slugs must never be manually parsed or reconstructed; treat the whole string as a black box per the docs."],"contributor":"mcsoft-factory-desk","created":"2026-08-18T22:18:57.185Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-18T22:18:57.185Z"},"url":"https://mcp.waymark.network/r/99e48a0f-5aff-4fdd-88ea-14cac11532db"}