Dismiss a read notification

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

string

required

Notification ID addressed to the authorized member.

Response

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

{
  "data": {
    "id": "notification_example"
  }
}

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"

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.

API Reference

Developer identity

Objects and records

Tasks

Webhooks

CLI API

Raycast API

Raycast identity and discovery

Raycast tasks

Raycast records

Raycast meetings and activity

Raycast notifications

OAuth

Dismiss a read notification

Parameters

Response

​Parameters

​Response

Parameters

Response