Actions

Manage test actions (rules) that automatically modify test behavior.

Actions allow you to:

• Skip tests that match certain conditions

• Quarantine flaky tests so their failures don't fail the run

• Tag tests with custom labels for organization

Each action has a matcher that defines which tests it applies to, based on conditions like test title, file path, tags, git branch, etc.

List actions

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions

Get all actions for a project with optional filtering

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Query parameters

projectIdstringRequired

The project ID

Example: proj_abc123

searchstring · max: 100Optional

Search actions by name

Example: flaky test

Responses

200

Successful response

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/actions

HTTPcURLJavaScriptPython

GET /v1/actions?projectId=text HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": [
    {
      "actionId": "text",
      "name": "text",
      "description": "text",
      "action": [
        {
          "op": "skip"
        }
      ],
      "matcher": {
        "op": "AND",
        "cond": [
          {
            "type": "title",
            "op": "in",
            "value": [
              "flaky"
            ]
          },
          {
            "type": "project",
            "op": "eq",
            "value": "chromium"
          }
        ]
      },
      "status": "active",
      "createdAt": "2026-03-26T02:59:40.872Z",
      "createdBy": "text",
      "updatedAt": "2026-03-26T02:59:40.872Z",
      "updatedBy": "text",
      "disabledAt": "2026-03-26T02:59:40.872Z",
      "disabledBy": "text",
      "archivedAt": "2026-03-26T02:59:40.872Z",
      "archivedBy": "text",
      "expiresAfter": "2026-03-26T02:59:40.872Z"
    }
  ]
}

Create action

post

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions

Create a new action for a project

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Query parameters

projectIdstringRequired

The project ID

Example: proj_abc123

Body

application/json

namestring · min: 1 · max: 255Required

descriptionstring · max: 1000 · nullableOptional

expiresAfterstring · date-time · nullableOptional

Responses

201

Action created successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

post

/actions

HTTPcURLJavaScriptPython

POST /v1/actions?projectId=text HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 228

{
  "name": "text",
  "description": "text",
  "action": [
    {
      "op": "skip"
    }
  ],
  "matcher": {
    "op": "AND",
    "cond": [
      {
        "type": "title",
        "op": "in",
        "value": [
          "flaky"
        ]
      },
      {
        "type": "project",
        "op": "eq",
        "value": "chromium"
      }
    ]
  },
  "expiresAfter": "2026-03-26T02:59:40.872Z"
}

{
  "status": "OK",
  "data": {
    "actionId": "text",
    "name": "text",
    "description": "text",
    "action": [
      {
        "op": "skip"
      }
    ],
    "matcher": {
      "op": "AND",
      "cond": [
        {
          "type": "title",
          "op": "in",
          "value": [
            "flaky"
          ]
        },
        {
          "type": "project",
          "op": "eq",
          "value": "chromium"
        }
      ]
    },
    "status": "active",
    "createdAt": "2026-03-26T02:59:40.872Z",
    "createdBy": "text",
    "updatedAt": "2026-03-26T02:59:40.872Z",
    "updatedBy": "text",
    "disabledAt": "2026-03-26T02:59:40.872Z",
    "disabledBy": "text",
    "archivedAt": "2026-03-26T02:59:40.872Z",
    "archivedBy": "text",
    "expiresAfter": "2026-03-26T02:59:40.872Z"
  }
}

Get action

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/{actionId}

Get a single action by ID. The actionId is globally unique, so projectId is not required.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

actionIdstringRequired

The action ID

Example: 507f1f77bcf86cd799439011

Responses

200

Successful response

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/actions/{actionId}

HTTPcURLJavaScriptPython

GET /v1/actions/{actionId} HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "actionId": "text",
    "name": "text",
    "description": "text",
    "action": [
      {
        "op": "skip"
      }
    ],
    "matcher": {
      "op": "AND",
      "cond": [
        {
          "type": "title",
          "op": "in",
          "value": [
            "flaky"
          ]
        },
        {
          "type": "project",
          "op": "eq",
          "value": "chromium"
        }
      ]
    },
    "status": "active",
    "createdAt": "2026-03-26T02:59:40.872Z",
    "createdBy": "text",
    "updatedAt": "2026-03-26T02:59:40.872Z",
    "updatedBy": "text",
    "disabledAt": "2026-03-26T02:59:40.872Z",
    "disabledBy": "text",
    "archivedAt": "2026-03-26T02:59:40.872Z",
    "archivedBy": "text",
    "expiresAfter": "2026-03-26T02:59:40.872Z"
  }
}

Update action

put

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/{actionId}

Update an existing action. The actionId is globally unique, so projectId is not required.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

actionIdstringRequired

The action ID

Example: 507f1f77bcf86cd799439011

Body

application/json

namestring · min: 1 · max: 255Optional

descriptionstring · max: 1000 · nullableOptional

expiresAfterstring · date-time · nullableOptional

Responses

200

Action updated successfully

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

put

/actions/{actionId}

HTTPcURLJavaScriptPython

PUT /v1/actions/{actionId} HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 228

{
  "name": "text",
  "description": "text",
  "action": [
    {
      "op": "skip"
    }
  ],
  "matcher": {
    "op": "AND",
    "cond": [
      {
        "type": "title",
        "op": "in",
        "value": [
          "flaky"
        ]
      },
      {
        "type": "project",
        "op": "eq",
        "value": "chromium"
      }
    ]
  },
  "expiresAfter": "2026-03-26T02:59:40.872Z"
}

{
  "status": "OK",
  "data": {
    "actionId": "text",
    "name": "text",
    "description": "text",
    "action": [
      {
        "op": "skip"
      }
    ],
    "matcher": {
      "op": "AND",
      "cond": [
        {
          "type": "title",
          "op": "in",
          "value": [
            "flaky"
          ]
        },
        {
          "type": "project",
          "op": "eq",
          "value": "chromium"
        }
      ]
    },
    "status": "active",
    "createdAt": "2026-03-26T02:59:40.872Z",
    "createdBy": "text",
    "updatedAt": "2026-03-26T02:59:40.872Z",
    "updatedBy": "text",
    "disabledAt": "2026-03-26T02:59:40.872Z",
    "disabledBy": "text",
    "archivedAt": "2026-03-26T02:59:40.872Z",
    "archivedBy": "text",
    "expiresAfter": "2026-03-26T02:59:40.872Z"
  }
}

Delete action

delete

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/{actionId}

Archive an action (soft delete). The actionId is globally unique, so projectId is not required.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

actionIdstringRequired

The action ID

Example: 507f1f77bcf86cd799439011

Responses

200

Action archived successfully

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

delete

/actions/{actionId}

HTTPcURLJavaScriptPython

DELETE /v1/actions/{actionId} HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "actionId": "text",
    "archived": true
  }
}

Enable action

put

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/{actionId}/enable

Enable a disabled action. The actionId is globally unique, so projectId is not required.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

actionIdstringRequired

The action ID

Example: 507f1f77bcf86cd799439011

Responses

200

Action enabled successfully

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

put

/actions/{actionId}/enable

HTTPcURLJavaScriptPython

PUT /v1/actions/{actionId}/enable HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "actionId": "text",
    "name": "text",
    "description": "text",
    "action": [
      {
        "op": "skip"
      }
    ],
    "matcher": {
      "op": "AND",
      "cond": [
        {
          "type": "title",
          "op": "in",
          "value": [
            "flaky"
          ]
        },
        {
          "type": "project",
          "op": "eq",
          "value": "chromium"
        }
      ]
    },
    "status": "active",
    "createdAt": "2026-03-26T02:59:40.872Z",
    "createdBy": "text",
    "updatedAt": "2026-03-26T02:59:40.872Z",
    "updatedBy": "text",
    "disabledAt": "2026-03-26T02:59:40.872Z",
    "disabledBy": "text",
    "archivedAt": "2026-03-26T02:59:40.872Z",
    "archivedBy": "text",
    "expiresAfter": "2026-03-26T02:59:40.872Z"
  }
}

Disable action

put

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/{actionId}/disable

Disable an active action. The actionId is globally unique, so projectId is not required.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

actionIdstringRequired

The action ID

Example: 507f1f77bcf86cd799439011

Responses

200

Action disabled successfully

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

put

/actions/{actionId}/disable

HTTPcURLJavaScriptPython

PUT /v1/actions/{actionId}/disable HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "actionId": "text",
    "name": "text",
    "description": "text",
    "action": [
      {
        "op": "skip"
      }
    ],
    "matcher": {
      "op": "AND",
      "cond": [
        {
          "type": "title",
          "op": "in",
          "value": [
            "flaky"
          ]
        },
        {
          "type": "project",
          "op": "eq",
          "value": "chromium"
        }
      ]
    },
    "status": "active",
    "createdAt": "2026-03-26T02:59:40.872Z",
    "createdBy": "text",
    "updatedAt": "2026-03-26T02:59:40.872Z",
    "updatedBy": "text",
    "disabledAt": "2026-03-26T02:59:40.872Z",
    "disabledBy": "text",
    "archivedAt": "2026-03-26T02:59:40.872Z",
    "archivedBy": "text",
    "expiresAfter": "2026-03-26T02:59:40.872Z"
  }
}

List affected tests

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/tests

Get tests affected by actions (quarantine, skip, tag) for a project within a date range. Returns aggregated data grouped by test signature.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Query parameters

projectIdstringRequired

The project ID

Example: proj_abc123

date_startstring · date-timeRequired

Start date in ISO 8601 format

Example: 2024-01-01T00:00:00.000Z

date_endstring · date-timeRequired

End date in ISO 8601 format

Example: 2024-01-31T23:59:59.999Z

pageintegerOptional

Page number (0-indexed)

Default: 0

limitinteger · min: 1 · max: 100Optional

Maximum number of results (1-100)

Default: 25

searchstring · max: 100Optional

Search by spec file path, test title, or action name (case-insensitive)

action_idstringOptional

Filter by specific action ID (action_id)

dirstring · enumOptional

Sort direction for lastSeen (default: desc)

Default: descPossible values:

Responses

200

Successful response

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/actions/tests

HTTPcURLJavaScriptPython

GET /v1/actions/tests?projectId=text&date_start=2026-03-26T02%3A59%3A40.872Z&date_end=2026-03-26T02%3A59%3A40.872Z HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "list": [
      {
        "signature": "text",
        "title": "text",
        "specFile": "text",
        "actions": [
          {
            "types": [
              "quarantine"
            ],
            "name": "text",
            "id": "text",
            "status": "active",
            "expiresAt": "2026-03-26T02:59:40.872Z",
            "tags": [
              "text"
            ],
            "lastSeen": "2026-03-26T02:59:40.872Z",
            "recordingCount": 1
          }
        ],
        "lastSeen": "2026-03-26T02:59:40.872Z",
        "recordingCount": 1
      }
    ],
    "count": 1,
    "total": 1,
    "nextPage": 1
  }
}

Get affected test executions

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/tests/{signature}

Get execution details for a specific affected test (by signature) within a date range. Returns individual test execution records with action info. Results are paginated with cursor-based pagination using the starting_after and ending_before query parameters. To list executions for a single rule across all tests, use GET /actions/{actionId}/tests instead of the removed action_id query parameter.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

signaturestringRequired

Test signature hash

Query parameters

projectIdstringRequired

The project ID

Example: proj_abc123

date_startstring · date-timeRequired

Start date in ISO 8601 format

Example: 2024-01-01T00:00:00.000Z

date_endstring · date-timeRequired

End date in ISO 8601 format

Example: 2024-01-31T23:59:59.999Z

limitinteger · min: 1 · max: 50Optional

Maximum number of executions (1-50)

Default: 25

starting_afterstringOptional

Cursor for pagination. Returns items after this cursor value.

ending_beforestringOptional

Cursor for pagination. Returns items before this cursor value.

searchstring · max: 100Optional

Search by action name (case-insensitive)

Responses

200

Successful response

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/actions/tests/{signature}

HTTPcURLJavaScriptPython

GET /v1/actions/tests/{signature}?projectId=text&date_start=2026-03-26T02%3A59%3A40.872Z&date_end=2026-03-26T02%3A59%3A40.872Z HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "executions": [
      {
        "cursor": "text",
        "runId": "text",
        "instanceId": "text",
        "testId": "text",
        "specFile": "text",
        "title": "text",
        "signature": "text",
        "branch": "text",
        "commitSha": "text",
        "commitMessage": "text",
        "executedAt": "2026-03-26T02:59:40.872Z"
      }
    ],
    "has_more": true
  }
}

Get affected test executions for an action

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/actions/{actionId}/tests

List test executions where this rule/action was applied, within a date range. Same cursor pagination and filters as GET /actions/tests/{signature} except projectId is taken from the rule (after org ownership checks).

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

actionIdstringRequired

The action ID

Example: 507f1f77bcf86cd799439011

Query parameters

date_startstring · date-timeRequired

Start date in ISO 8601 format

Example: 2024-01-01T00:00:00.000Z

date_endstring · date-timeRequired

End date in ISO 8601 format

Example: 2024-01-31T23:59:59.999Z

limitinteger · min: 1 · max: 50Optional

Maximum number of executions (1-50)

Default: 25

starting_afterstringOptional

Cursor for pagination. Returns items after this cursor value.

ending_beforestringOptional

Cursor for pagination. Returns items before this cursor value.

searchstring · max: 100Optional

Search by action name (case-insensitive)

Responses

200

Successful response

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/actions/{actionId}/tests

HTTPcURLJavaScriptPython

GET /v1/actions/{actionId}/tests?date_start=2026-03-26T02%3A59%3A40.872Z&date_end=2026-03-26T02%3A59%3A40.872Z HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "executions": [
      {
        "cursor": "text",
        "runId": "text",
        "instanceId": "text",
        "testId": "text",
        "specFile": "text",
        "title": "text",
        "signature": "text",
        "branch": "text",
        "commitSha": "text",
        "commitMessage": "text",
        "executedAt": "2026-03-26T02:59:40.872Z"
      }
    ],
    "has_more": true
  }
}