# CircleCI

## CircleCI Actions <a href="#circleci-actions" id="circleci-actions"></a>

[<mark style="color:blue;">CircleCI</mark>](https://circleci.com/) is a modern continuous integration and continuous delivery (CI/CD) platform. CircleCI automates build, test, and deployment of software.

Squadcast’s **Extension** with CircleCI enables you to rebuild projects from within the Squadcast platform.

This is primarily helpful in a situation where you want to quickly mitigate a *customer experience* issue by rolling back to an older successful build.

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

* Only the Account Owner and Users with the <mark style="color:red;">`Manage Extensions`</mark> permission will be able to enable, disable and manage Extensions in Squadcast

## Enabling CircleCI Extension <a href="#enabling-circleci-extension" id="enabling-circleci-extension"></a>

1. Navigate to **Settings** and select the **Extensions** tab from the left navigation sidebar
2. Move over to the CircleCI extension and click on **Integrate**

<figure><img src="/files/EXelV59s5NstmwgYWohk" alt="Enable CircleCI extensions" width="563"><figcaption></figcaption></figure>

3. In your CircleCI dashboard, move over to **User Settings**

![User setting in circleCI dashboard](/files/IDNmGunnS3xRTuOJTHw9)

4. Click on **Personal API Tokens** and then, **Create New Token** to create a new API token for Squadcast

<figure><img src="/files/bOWL4njsPQfZQH65kxOU" alt="Create new API token for Squadcast" width="563"><figcaption></figcaption></figure>

5. Use a meaningful name for the token like “Squadcast” or “Squadcast Incidents”. Click on **Add API Token** to save and view the API Token

<div><figure><img src="/files/y4lg1u0FICHPIdPiNddQ" alt="Give a name to API token"><figcaption></figcaption></figure> <figure><img src="/files/5f4mbTsbvtfcXukUZbw4" alt="Create a new API token"><figcaption></figcaption></figure></div>

6. Copy the API Token shown in the CircleCI screen

![Click to copy the API token](/files/i8qGVHJKq9MZNIVLofiN)

7. Paste the copied API Token in the Squadcast CircleCI extension screen and click on **Save** to enable your CircleCI integration

![Paste the copied API Token in the Squadcast CircleCI extension](/files/i6wZiLeVoOJMcQT5GQMb)

Your CircleCI integration is good to go and you will be able to perform CircleCI actions directly for any incident.

![Perform CircleCI actions directly for any incident](/files/svqh3pdPZWGdSWHvwbj1)

## Using CircleCI Actions <a href="#using-circleci-actions" id="using-circleci-actions"></a>

Now that the CircleCI extension is enabled, follow the steps below to understand how to take CircleCI actions from within Squadcast.

1. Navigate to the [<mark style="color:blue;">Incident Details</mark>](/incidents-page/incidents-details.md) page of an incident for which you want to take the CircleCI action. In this example, we’re choosing the incident below to demonstrate.
2. Click on **Actions** to see a list of allowed/enabled actions for your Organization

<figure><img src="/files/UcmNeDt0Zmw2q3T5J0zh" alt="List of allowed/enabled CirlceCI actions within Squadcast" width="563"><figcaption></figcaption></figure>

3. Select **CircleCI** from the list of allowed/enabled actions

<div><figure><img src="/files/HzGUtfWBhGLoJPjq5Ygj" alt="Select CircleCI from the list of allowed/enabled actions"><figcaption></figcaption></figure> <figure><img src="/files/ZraveJhXqqofZBXsPAGY" alt="Select CircleCI from the list of allowed/enabled actions"><figcaption></figcaption></figure></div>

4. Click on **Rebuild** from the **Actions** to see a list of projects you can take this action on

![Rebuild from the Actions to see a list of projects](/files/kgggZCwSXQWSwl8qGsbI)

5. Click on a **Project** of your choice and the **Build** you want to rollback to

<div><figure><img src="/files/ULpaorqP7eiy7JuoyCRM" alt="Select the project to build via CircleCI"><figcaption></figcaption></figure> <figure><img src="/files/6qfUkypXN98hn9u3XOF5" alt="Build the project and rollback via CircleCI"><figcaption></figcaption></figure></div>

6. Click the **Rebuild** button to trigger the build again and you can see the link to the CircleCI build in the resulting screen\\

<div><figure><img src="/files/ur4WpoCdeeogsTvR7bvK" alt="Click the Rebuild button to trigger the build again"><figcaption></figcaption></figure> <figure><img src="/files/pofYihbeTYe4W3tCJiD8" alt="Check the link to the CircleCI build"><figcaption></figcaption></figure></div>

You will also be able to see the actions performed in the **Incident Activity Timeline** on the right.

![Actions performed in the incident activity timeline in CircleCI](/files/2m08C2SrhTcMd1laLCtT)

The link will take you straight to the CircleCI **Jobs View** screen showing the result of the triggered build action.

<figure><img src="/files/gYBGT2drhDYdmQ9Lg630" alt="CircleCI job view dashboard" width="563"><figcaption></figcaption></figure>

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*


---

# Agent Instructions: 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:

```
GET https://support.squadcast.com/integrations/extensions/circleci.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
