> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/project-management/circleci/faq.md).

# FAQ

<details>

<summary>Which CircleCI plan do I need to use this integration?</summary>

Coupler.io works with any CircleCI plan that provides API access, including the Free plan. However, some data — like advanced Insights metrics — may only be available on Performance or Scale plans depending on your CircleCI subscription.

</details>

<details>

<summary>Where do I find my Project ID?</summary>

Go to your CircleCI project settings. The Project ID appears in the URL: `https://app.circleci.com/settings/project/circleci/ORG_SLUG/PROJECT_ID`. Copy the UUID at the end and paste it into the Project ID parameter in Coupler.io.

</details>

<details>

<summary>Can I pull data from multiple CircleCI projects in one data flow?</summary>

Yes. Add multiple sources to a single data flow — one per project — and use the **Append** transformation to combine them into one unified table at the destination. This is useful for cross-project pipeline dashboards.

</details>

<details>

<summary>Do I need to set a workflow ID or job number?</summary>

For most entities, these are optional. If you don't provide a job number, Coupler.io will attempt to auto-fetch it from the Workflow jobs entity. Workflow IDs are only required if you want to scope data to specific workflows — otherwise, pipeline-level entities return data across all workflows.

</details>

<details>

<summary>Why does the Contexts entity return a permission error?</summary>

Context data in CircleCI is typically restricted to organization admins. If your API token belongs to a non-admin user, you'll see a 403 error. You'll need an org admin to generate the token or grant your account elevated permissions. See the [Common Issues](/sources/category/project-management/circleci/common-issues.md) article for more detail.

</details>

<details>

<summary>Can I send CircleCI data to an AI tool like ChatGPT or Claude?</summary>

Yes. When setting up your data flow destination, select one of the available AI destinations — ChatGPT, Claude, Gemini, Perplexity, Cursor, or OpenClaw. This lets you feed pipeline metrics, failure trends, or insights data directly into an AI assistant for automated analysis or reporting.

</details>

<details>

<summary>How far back can I pull historical pipeline data?</summary>

This depends on your CircleCI plan's data retention policy. CircleCI limits how far back the API returns records, so very old pipelines may not be available regardless of the start date you configure. For best results, set a start date within your plan's retention window.

</details>

<details>

<summary>What's the difference between Jobs and Workflow jobs?</summary>

Workflow jobs returns all jobs associated with a specific workflow run. Jobs is a more targeted entity that fetches data for a specific job number. In most cases, start with Workflow jobs to get an overview, then use Jobs if you need detailed data for a particular job.

</details>

{% hint style="info" %}
For details on what fields each entity returns, see the [Data Overview](/sources/category/project-management/circleci/data-overview.md) article. For connection problems or empty results, check [Common Issues](/sources/category/project-management/circleci/common-issues.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/project-management/circleci/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.