# Dismiss a detector finding with a reason

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Evaluation & reporting](https://everruns.com/docs/api/groups/evaluation-reporting/)/Dismiss a detector finding with a reason

# Dismiss a detector finding with a reason

Preview

Close a finding that needs nothing. The reason is kept to calibrate detectors, and a dismissed session finding stays closed when the same session is flagged again.

Public APIEverruns Cloud and self-hosted Platform

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

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

## Parameters

### Path Parameters

**issue_id**

required

string format: uuid

## Request Bodyrequired

Media typeapplication/json

Why a finding needs nothing.

object

**note**

required

A false alarm, expected work, or already handled. Kept so detectors can be calibrated against it. (Named `note` because `reason` is the change-intent flag every command takes.)

string

### Example

```plaintext
Expected: this is our nightly load test
```

## Responses

200

### 200

Media typeapplication/json

An organization-scoped operational issue and its current recovery evidence.

object

**agent_id**

Public identifier of the owning agent; absent for an organization-level issue.

string | null

**agent_name**

Display name of the owning agent; absent for an organization-level issue.

string | null

**body**

required

Explanation of the impact and recovery action.

string

**channel_id**

Public identifier of the affected channel; absent for an organization-level issue.

string | null

**code**

required

Detector code: `slack.permissions` for a channel, `org.active_turn_limit` for the organization.

string

**error_code**

Sanitized provider or verification error code, when available.

string | null

**evidence**

The numbers a detector or classifier recorded for a finding: counts, costs, probabilities. Never session content.

object | null

**first_detected_at**

required

Time the current issue episode was first detected.

string format: date-time

**fixers**

required

Repairs Everruns can make for the issue now, in the order to offer them. Empty when it has none, or the issue is resolved.

Array\<object>

A repair Everruns can make for an issue.

object

**effect**

required

`in_place` when running it is the whole fix; `consent` when the person then approves the change in the provider.

string

**kind**

required

What it does: `slack.add_permissions`, `slack.reconnect` or `schedule.pause`.

string

**label**

required

Button text.

string

**needs_provider_admin**

required

Whether the provider may ask a workspace administrator to approve.

boolean

**steps**

required

What happens when it runs, step by step, in plain words.

Array\<string>

**unavailable_reason**

Why it cannot run now, and what unlocks it. Absent when it can run.

string | null

**unblock**

One of:

* object

  The page where the person takes the step that unlocks the fix, when one exists in Everruns. Absent when the fix can run, or when nothing in Everruns unlocks it (only the manual steps remain).

  object

  **href**

  required

  A path inside the Everruns console, never an external URL.

  string

  **label**

  required

  Button text.

  string

* null

  null

**undoable**

required

Whether the fix can be undone from the finding.

boolean

**href**

required

Application-relative link to the issue details.

string

**id**

required

Stable identifier of the canonical issue.

string format: uuid

**investigation**

One of:

* object

  The Inspector’s write-up of a finding’s current episode, when it has one.

  object

  **cluster_id**

  The cluster of similar findings in this organization.

  string | null format: uuid

  **cluster_open**

  Open findings in the cluster, this one included.

  integer | null format: int64

  **cluster_title**

  Title of that cluster, naming the problem the findings share.

  string | null

  **completed_at**

  When the write-up was finished.

  string | null format: date-time

  **dismiss_reason**

  The note the person gave when dismissing.

  string | null

  **dismissed_at**

  When a person dismissed the finding, and why.

  string | null format: date-time

  **model**

  The model that wrote it.

  string | null

  **severity**

  `high`, `medium` or `low`, as the Inspector judged it.

  string | null

  **status**

  required

  `running`, `done`, `failed`, or `unavailable` (no model to write it).

  string

  **suggested_action**

  One concrete next step.

  string | null

  **what_happened**

  What happened, in two to four plain sentences.

  string | null

* null

  null

**last_checked_at**

required

Time the latest accepted verification evidence was observed.

string format: date-time

**missing_scopes**

required

Required Slack scopes absent from the verified grant.

Array\<string>

**notification_id**

Current user’s announcement identifier, when one was issued.

string | null

**session_id**

Public identifier of the session the issue points at, when it has one.

string | null

**snoozed_until**

Current user’s reminder suppression deadline, if snoozed.

string | null format: date-time

**stale**

required

Whether the evidence is old, unavailable, or for a previous channel revision.

boolean

**status**

required

Current issue state: open, needs_check, resolved, or inapplicable.

string

**subject_id**

What a background-work issue is about: a schedule (`sched_…`), an agent (`agent_…`), a session (`session_…`) or the organization (`org_…`).

string | null

**title**

required

Human-readable summary of the required action.

string

### Example

```json
{
  "agent_id": "agent_550e8400e29b41d4a716446655440000",
  "agent_name": "Support assistant",
  "body": "Reconnect Slack to grant the required permissions.",
  "channel_id": "appchan_550e8400e29b41d4a716446655440000",
  "code": "slack.permissions",
  "error_code": "missing_scope",
  "first_detected_at": "2026-10-03T12:00:00Z",
  "fixers": [
    {
      "effect": "consent",
      "kind": "slack.add_permissions",
      "label": "Fix in Slack",
      "unblock": {
        "href": "/settings/slack",
        "label": "Reconnect Slack workspace"
      }
    }
  ],
  "href": "/settings/health?issue=550e8400-e29b-41d4-a716-446655440000",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "investigation": {
    "cluster_id": "550e8400-e29b-41d4-a716-446655440000",
    "cluster_open": 3,
    "cluster_title": "Schedules polling an expired claim",
    "completed_at": "2026-10-18T21:40:00Z",
    "dismiss_reason": "Expected: load test",
    "model": "gpt-6.2-sol",
    "severity": "high",
    "status": "done",
    "suggested_action": "Add a stop rule to the schedule's instructions.",
    "what_happened": "The schedule polls a sign-in claim that expired; every run since reports the same error."
  },
  "last_checked_at": "2026-10-03T12:05:00Z",
  "missing_scopes": [
    "reactions:write"
  ],
  "notification_id": "notification_550e8400e29b41d4a716446655440001",
  "session_id": "session_550e8400e29b41d4a716446655440000",
  "snoozed_until": "2026-10-04T12:00:00Z",
  "stale": false,
  "status": "open",
  "subject_id": "sched_550e8400e29b41d4a716446655440000",
  "title": "Slack permissions need updating"
}
```

404

### 404

Media typeapplication/json

Standard error response.

Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.

object

**allowed_actions**

Recovery actions the caller can take next.

Array\<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

* **Error recovery** — `ErrorResponse.allowed_actions` carries `rel`s like `retry`, `retry-later`, `unarchive`, `get-existing` so the agent knows the right next call after a 4xx/429.
* **Entity hypermedia** — `WithUrls<T>.allowed_actions` carries state-aware `rel`s like `cancel`, `events`, `self`, `update` on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed `rel` vocabulary distinguishes them.

object

**hint**

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

**href**

Absolute (preferred) or relative URL the caller may invoke directly. **Always present on entity hypermedia actions** (`WithUrls<T>.allowed_actions`); **optional on error-recovery actions** (`ErrorResponse.allowed_actions`) where the matching `operation_id` is enough and the URI is implicit from the failed call.

string | null

**method**

HTTP method to use against `href`. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

**operation_id**

OpenAPI `operationId` the caller should invoke. Lets an MCP client resolve the call without parsing `href`.

string | null

**rel**

required

Link relation describing the action. Examples: `self`, `cancel`, `pause`, `resume`, `events`, `retry`, `retry-later`, `unarchive`, `get-existing`, `delete`, `update`.

string

**schema_ref**

OpenAPI `$ref` to the request-body schema, when the action takes one (e.g. `#/components/schemas/UpdateSessionRequest`). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

**code**

Stable, machine-readable error code (snake_case).

string | null

**detail**

Human-readable explanation specific to this occurrence.

string | null

**instance**

Request URI for this occurrence.

string | null

**retry_after_seconds**

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32

**status**

required

HTTP status code; mirrors the response status line.

integer format: int32

**title**

required

Short, human-readable summary of the problem (e.g. “Not Found”).

string

**type**

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null

### Example

```json
{
  "allowed_actions": [
    {
      "method": "POST"
    }
  ],
  "code": "session_not_found",
  "detail": "Session session_01933b5a000070008000000000000001 not found in org org_01933b5a000070008000000000000001.",
  "instance": "/v1/sessions/session_01933b5a000070008000000000000001",
  "retry_after_seconds": 30,
  "status": 404,
  "title": "Session not found",
  "type": "https://everruns.com/docs/errors/session_not_found"
}
```

409

### 409

Media typeapplication/json

Standard error response.

Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.

object

**allowed_actions**

Recovery actions the caller can take next.

Array\<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

* **Error recovery** — `ErrorResponse.allowed_actions` carries `rel`s like `retry`, `retry-later`, `unarchive`, `get-existing` so the agent knows the right next call after a 4xx/429.
* **Entity hypermedia** — `WithUrls<T>.allowed_actions` carries state-aware `rel`s like `cancel`, `events`, `self`, `update` on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed `rel` vocabulary distinguishes them.

object

**hint**

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

**href**

Absolute (preferred) or relative URL the caller may invoke directly. **Always present on entity hypermedia actions** (`WithUrls<T>.allowed_actions`); **optional on error-recovery actions** (`ErrorResponse.allowed_actions`) where the matching `operation_id` is enough and the URI is implicit from the failed call.

string | null

**method**

HTTP method to use against `href`. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

**operation_id**

OpenAPI `operationId` the caller should invoke. Lets an MCP client resolve the call without parsing `href`.

string | null

**rel**

required

Link relation describing the action. Examples: `self`, `cancel`, `pause`, `resume`, `events`, `retry`, `retry-later`, `unarchive`, `get-existing`, `delete`, `update`.

string

**schema_ref**

OpenAPI `$ref` to the request-body schema, when the action takes one (e.g. `#/components/schemas/UpdateSessionRequest`). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

**code**

Stable, machine-readable error code (snake_case).

string | null

**detail**

Human-readable explanation specific to this occurrence.

string | null

**instance**

Request URI for this occurrence.

string | null

**retry_after_seconds**

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32

**status**

required

HTTP status code; mirrors the response status line.

integer format: int32

**title**

required

Short, human-readable summary of the problem (e.g. “Not Found”).

string

**type**

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null

### Example

```json
{
  "allowed_actions": [
    {
      "method": "POST"
    }
  ],
  "code": "session_not_found",
  "detail": "Session session_01933b5a000070008000000000000001 not found in org org_01933b5a000070008000000000000001.",
  "instance": "/v1/sessions/session_01933b5a000070008000000000000001",
  "retry_after_seconds": 30,
  "status": 404,
  "title": "Session not found",
  "type": "https://everruns.com/docs/errors/session_not_found"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/health-issues/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/dismiss';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"note":"Expected: this is our nightly load test"}'
};


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/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/dismiss \
  --header 'Content-Type: application/json' \
  --data '{ "note": "Expected: this is our nightly load test" }'
```

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

200404409

200 ·

```json
{
  "agent_id": "agent_550e8400e29b41d4a716446655440000",
  "agent_name": "Support assistant",
  "body": "Reconnect Slack to grant the required permissions.",
  "channel_id": "appchan_550e8400e29b41d4a716446655440000",
  "code": "slack.permissions",
  "error_code": "missing_scope",
  "first_detected_at": "2026-10-03T12:00:00Z",
  "fixers": [
    {
      "effect": "consent",
      "kind": "slack.add_permissions",
      "label": "Fix in Slack",
      "needs_provider_admin": true,
      "steps": [
        "string"
      ],
      "undoable": true
    }
  ],
  "href": "/settings/health?issue=550e8400-e29b-41d4-a716-446655440000",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "last_checked_at": "2026-10-03T12:05:00Z",
  "missing_scopes": [
    "reactions:write"
  ],
  "notification_id": "notification_550e8400e29b41d4a716446655440001",
  "session_id": "session_550e8400e29b41d4a716446655440000",
  "snoozed_until": "2026-10-04T12:00:00Z",
  "stale": false,
  "status": "open",
  "subject_id": "sched_550e8400e29b41d4a716446655440000",
  "title": "Slack permissions need updating"
}
```

404 ·

```json
{
  "status": 404
}
```

409 ·

```json
{
  "status": 409
}
```

## Matching endpoints