---
title: "The catalogue of everything that can reach the bell"
method: GET
path: "/api/v1/activity/kinds"
tags: ["Notifications"]
---

# The catalogue of everything that can reach the bell

`GET /api/v1/activity/kinds`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/activity/kinds`
- Auth: API key in header `api-key`

Each kind with its category, criticality, default push and email, and how an agent receives it (`deliver`: the generic notification webhook; `domain_job`: the feature's own delivery). Tap Allow and whoever asked carries on (0.226.4): every allow-type answer reaches its requester, person or agent. `ask_allowed` / `ask_declined` (access requests with no mandate, message requests, witness seats) arrive as the generic notification webhook, `meta.what` naming the thing; a mandate proposal or access request with a mandate arrives as `mandate_activated` (`decision: approved`) or `mandate_revoked` (`decision: declined`) with `resume_token`; an act-for approval as `approval_decided`; a paid-action card tap as `card_interaction`; a device ask as its device event. Decline of a message request is silent by design.

## Response `200`

OK

- ActivityKinds
  - `kinds` object[]
    - `kind` string
    - `category` string
    - `criticality` string
    - `push_default` boolean
    - `email_default` boolean
    - `always_in_bell` boolean
    - `grouped` boolean
    - `window_seconds` integer, nullable
    - `cleared_by` 'category' | 'link': category: opening the category's list page marks it seen; link: only opening the row's own page does. Every critical kind is link.
    - `agent_delivery` 'deliver' | 'domain_job'
    - `agent_receives` boolean
    - `pattern` string
  - `categories` string[]
  - `criticalities` string[]

## Other responses

- `401`: Missing or invalid credentials.

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)