> For the complete documentation index, see [llms.txt](https://docs.currents.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.currents.dev/guides/currents-actions/using-currents-actions.md).

# Using Currents Actions

Create and Manage Currents Actions, trace action applications and outcomes

{% hint style="info" %}

* Users with **Admin** role can create and modify actions.
* Users with **Actions admin** role can create and modify actions
* Users with **Member** role can browse actions in read-only mode.
  {% endhint %}

Access the Actions Management view via **Menu > Manage Project > Actions** to browse, create and modify actions.

### Action State

An action can be in one of the following states:

* Active - the action is active and it will apply based on its conditions;
* Expired - the action has expired and isn't applicable anymore;
* Disabled - the action was disabled by a user.
* Archived - the action has been archived by a user.

By default only **Active** actions are visible, change the visibility filter to see additional items.

<div data-with-frame="true"><figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2F9Sgmhrak6gCxR2zd0io4%2FScreenshot%202026-09-22%20at%2011.56.45.png?alt=media&amp;token=0fb40b3c-4cc8-480d-8c90-4c7e50b0ded5" alt=""><figcaption><p>Actions Management View</p></figcaption></figure></div>

### Creating a new Action

Click **+ New** to open action creation modal. Enter the action details:

* **Name** - human readable name
* **Description** - verbose explanation of the action intent
* **Expiration date and time** - the action will be marked as Expired and will not apply after the specified date
* **Condition** - set of conditions (filters) that a test must satisfy to activate an action. Refer to [Conditions](/guides/currents-actions/reference/conditions.md) reference documentation
* **Actions** - set of actions that will apply if a test matches the conditions. Refer [Actions](/guides/currents-actions/reference/actions.md) reference documentation

<div data-with-frame="true"><figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FkICc7CMYKaKQAE6mqiEd%2FScreenshot%202026-09-22%20at%2012.00.01.png?alt=media&amp;token=ee470d4b-29cd-4fcd-87e6-2c0e5f0d6091" alt=""><figcaption><p>Action Creation Form</p></figcaption></figure></div>

Users with Admin role can **Disable** or **Edit** an action after its creation.

<div data-with-frame="true"><figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FEPdhmN7qf5VDfm9gYD8C%2FScreenshot%202026-09-22%20at%2012.05.29.png?alt=media&amp;token=542f27fb-2afc-44a4-822a-155c81b4b52d" alt=""><figcaption><p>Action Edit History</p></figcaption></figure></div>

### Action Creation Shortcut

When browsing test results you can create new actions using the inline Create Action shortcut. Clicking one of the predefined actions will open action creation form pre-populated with the current test details.

<div data-with-frame="true"><figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FfZh7RpERvDEItTFxcuYZ%2FScreenshot%202026-09-22%20at%2012.10.10.png?alt=media&amp;token=b21a5fa8-341b-4f95-93e6-aa342ff146ec" alt=""><figcaption><p>Using inline action creation shortcut</p></figcaption></figure></div>

### Action Traceability

If a test was affected by an action, it will display Insights with the action applied and its timestamp.

<div data-with-frame="true"><figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FAwM9o52OXkXwd62eZPx4%2FScreenshot%202026-09-22%20at%2012.25.44.png?alt=media&amp;token=4cc72037-e087-4aae-800d-db10dfb6c25c" alt=""><figcaption><p>Action Traceability</p></figcaption></figure></div>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.currents.dev/guides/currents-actions/using-currents-actions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
