# Act on a finding

Source: <https://everruns.com/docs/api/operations/take_finding_action/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Evaluation & reporting](https://everruns.com/docs/api/groups/evaluation-reporting/)/Act on a finding

# Act on a finding

Preview

Take an action the organization’s self-healing policy offers on a finding, such as pausing a schedule whose runs keep ending the same way. It is recorded on the finding and can be undone.

Public APIRequires the evals feature flag

POST`/v1/health-issues/{issue_id}/actions`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**issue_id**

required

string

Prefixed public identifier

## Request Bodyrequired

Media typeapplication/json

The action to take.

object

**kind**

required

`pause_schedule`.

string

### Example generated

```json
{
  "kind": "example"
}
```

## Responses

200Success

### 200

Success

Media typeapplication/json

What has been done about a finding, and what can be.

object

**actions**

required

Actions taken, newest first.

Array\<object>

An action taken on a finding.

object

**automatic**

required

Whether Everruns took it on its own under the org’s policy.

boolean

**created_at**

required

When it was taken.

string format: date-time

**current**

required

The finding episode it belongs to is the current one.

boolean

**id**

required

Prefixed public identifier (`fact_…`).

string

**kind**

required

What was done: `pause_schedule`.

string

**target_id**

required

What it acted on, by public id (a schedule’s `sched_…`).

string

**undone_at**

When it was undone, if it was.

string | null format: date-time

**available**

required

Actions the org’s policy offers for a person to take now.

Array\<object>

An action a person can take on a finding now.

object

**kind**

required

What it would do: `pause_schedule`.

string

**target_id**

required

What it would act on, by public id.

string

**mode**

One of:

* string

  The org’s policy for this kind of finding, when it has one.

  string

  Allowed values: auto suggest off

* null

  null

### Example

```json
{
  "mode": "auto"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/health-issues/example/actions';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"kind":"example"}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/health-issues/example/actions \
  --header 'Content-Type: application/json' \
  --data '{ "kind": "example" }'
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Success

```json
{
  "actions": [
    {
      "automatic": true,
      "created_at": "2026-10-12T09:00:00Z",
      "current": true,
      "id": "string",
      "kind": "string",
      "target_id": "string"
    }
  ],
  "available": [
    {
      "kind": "string",
      "target_id": "string"
    }
  ]
}
```

## Matching endpoints