> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dismiss a read notification

> Delete a read notification addressed to the authorized member.

Delete a read notification addressed to the authorized member.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `notifications:write`.

Only read notifications can be dismissed. An unread, missing, already dismissed, or inaccessible notification returns `400` with “Only read notifications can be dismissed”. Mark it read before dismissal.

## Parameters

<ParamField path="notificationId" type="string" required>
  Notification ID addressed to the authorized member.
</ParamField>

## Response

**200** — Returns the resource under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "notification_example"
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    -X DELETE \
    "https://api.getkato.io/v1/raycast/notifications/$KATO_NOTIFICATION_ID" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN"
  ```
</RequestExample>

Set path-ID environment variables to values returned by your workspace before running the request.

This request changes workspace data. A timeout does not prove that the write failed; inspect the result before retrying.


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [Mark notification read](/api-reference/raycast/notifications-read.md)
- [Mark all notifications read](/api-reference/raycast/notifications-read-all.md)
- [List notifications](/api-reference/raycast/notifications.md)
- [Mark notification unread](/api-reference/raycast/notifications-unread.md)