Installed apps
Connected apps and one install's Manage tabs (Settings › Connected apps): the lifecycle (setup,
pause, resume, re-consent, retry, uninstall), its agents, monitoring, activity and API request logs,
permissions and linked records. A signed-in person's session (or their personal access token):
integrations.read to read, integrations.manage to change anything, integrations.view_logs for
the two logs; the Integrations module must be on. Install ids are uuids only — a bigint or another
workspace's id is a 404. An app's own OAuth token is refused (403 resource_not_grantable).
Throttles count per session or token: every read shares app_installs/read/minute (300 a minute)
and every write app_installs/write/minute (30 a minute) — the agent mapping (PUT …/agents) has
a bucket of its own instead, and the three routes that schedule work a tighter one on top. Each
operation names its own.
Connected apps
Everything that can read or write this workspace's data: each partner install (newest first),
How many things need an admin
The Settings nav badge: the length of `GET /app_installs` `meta.attention`. `integrations.read`.
One install
What Manage and Setup read: the install's own facts, its ingest URL, the hourly quota (and whether
Change the setup config
`{config: {…}}`, partial — only the settings the request names change. Each must be allowed by
Uninstall
In one transaction: the install is `uninstalled` (with the optional reason), unexchanged codes
Finish setup
Stamps `setup_completed_at` (the funnel's last step). `integrations.manage`; `422 not_installed`.
Pause the app here
The admin's own switch; the status does not change. While paused the app's requests answer
Resume the app here
Clears the pause and applies the events held meanwhile, one after another in the order they
Answer a version that asks for more
Re-consent happens inside KudosCRM, never through a Kudos-built authorize URL. A release asks an
Retry stopped deliveries
After ten dead letters in a row (or a `410`) the install's webhook subscription stops and the
The partner's agents and who they are here
The agents the app reported (`PUT /app/agents`) or named in its events, the first 1,000 by name,
Match agents to members
Updates agents the app has already reported, matched by `external_id` (none is ever inserted), and
The last 24 hours, in numbers
Events in (received, failed, duplicates), API calls (count, `success_rate` — answers below 400 over
Events received per day
The events this install received, one row per UTC day, oldest first, today last and counted live;
What the app changed here
Creates, updates and deletes over the last `days` (1–30, default 7): calls and messages from the
Events waiting to apply
Up to 50, oldest first: updates that arrived before their call (retried at 30 s, 2 m, 10 m, 1 h,
What the app sent in and what KudosCRM sent out
One list, newest first, ordered (at, in before out, id) behind one keyset cursor. An inbound
Run an entry again
An inbound event goes back to pending and is processed again; a delivery is re-sent as a new
The app's API requests
The requests this install's tokens made (30 days), newest first, keyset-paged on (occurred_at,
What the app may do, and the grant's history
The granted scopes in catalog order with the developer's reason, the events its subscription
The partner's ids and the records they name
Without `external_id`: one count per kind of identity (calls, messages, people and accounts,
The setup terminal — recent events
The last 20 inbound events this install received, newest first, all `source: live` (a test
Run a test sequence
A synthetic call sequence — a duplicate included — through the real telephony mapper, in a