# Using Currents Actions

{% 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.

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

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FfCxlXgPtO00s28ckQAHJ%2FScreenshot%202026-01-09%20at%2017.53.13.png?alt=media&#x26;token=f27fab76-40aa-4c62-815e-3f8cd0d22f40" alt=""><figcaption><p>Actions Management View</p></figcaption></figure>

### Creating a new Action

Click **Create Action** 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](https://docs.currents.dev/guides/currents-actions/reference/conditions "mention") reference documentation
* **Actions** - set of actions that will apply if a test matches the conditions. Refer [actions](https://docs.currents.dev/guides/currents-actions/reference/actions "mention") reference documentation

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FMIZbK2illMOVRLIMp384%2FScreenshot%202026-01-09%20at%2017.55.54.png?alt=media&#x26;token=c5f767cf-2593-43ed-85bf-e1c06ae6de93" alt=""><figcaption><p>Action Creation Form</p></figcaption></figure>

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

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FkLTt5Td0YPVASAeDGjPK%2FScreenshot%202026-01-09%20at%2018.03.59.png?alt=media&#x26;token=b2a770ea-04d1-4fb3-a529-e9ce7e04a352" alt=""><figcaption><p>Action Edit History</p></figcaption></figure>

### 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.

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2F2SJs6C8eHyU7UPPghT4f%2FScreenshot%202026-01-09%20at%2018.16.14.png?alt=media&#x26;token=355d3837-51de-4197-abba-25ab2912b079" alt=""><figcaption><p>Using inline action creation shortcut</p></figcaption></figure>

### Action Traceability

If a test was affected by an action, it will display Actions Engine trace. Clicking on a trace item takes users to the associated Action definition.

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FtrWnSfCYsm7w3L9gaKQe%2FScreenshot%202026-01-09%20at%2018.30.04.png?alt=media&#x26;token=5d7c29cd-1f2a-4db7-b73d-adef3e223f49" alt=""><figcaption></figcaption></figure>


---

# 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://docs.currents.dev/guides/currents-actions/using-currents-actions.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.
