Organization and team
Who the connection is, the token's organization and the people who use the console, with their memberships and roles.
Families on this page​
| Family | Tools | read | write | destructive |
|---|---|---|---|---|
me — Connection identity | 1 | 1 | 0 | 0 |
organizations — Organization | 6 | 3 | 2 | 1 |
users — Users | 1 | 1 | 0 | 0 |
memberships — Memberships | 1 | 1 | 0 | 0 |
roles — Roles | 2 | 1 | 1 | 0 |
me​
| Tool | Kind | Scope | Permission | Endpoint | What it does |
|---|---|---|---|---|---|
kadu_me_get | read | — (any token) | — (membership only) | GET /v1/me | Who this connection is: the person (sub), the organization the token acts for, and the scopes it was granted. |
organizations​
| Tool | Kind | Scope | Permission | Endpoint | What it does |
|---|---|---|---|---|---|
kadu_organizations_list | read | kadu/organizations + read | agent.organizations.list | GET /v1/organizations | Lists the organization the token acts for (a token always reaches exactly one). |
kadu_organizations_get | read | kadu/organizations + read | agent.organizations.read | GET /v1/organizations/{id} | Gets the organization: label, timezone, monthly cost limit and the cost accumulated this month (USD). |
kadu_organizations_update | write | kadu/organizations + write | agent.organizations.update | PATCH /v1/organizations/{id} | Updates the token's own organization: label, timezone, custom metadata. |
kadu_organizations_slack_installations_list | read | kadu/organizations + read | agent.organizations.read | GET /v1/organizations/{id}/slack_installations | Lists the organization's Slack bot installations: workspace, where the bot answers, output files mode, detail in the thread and connected accounts. |
kadu_organizations_slack_installations_update | write | kadu/organizations + write | agent.organizations.update | PATCH /v1/organizations/{id}/slack_installations/{id} | Configures a Slack installation: allowed channel types (public channels and Slack Connect expose results to more people), output files as console link or attachment, and log detail in the thread. |
kadu_organizations_slack_installations_delete | destructive | kadu/organizations + delete | agent.organizations.update | DELETE /v1/organizations/{id}/slack_installations/{id} | Removes a Slack installation: revokes the bot token in Slack, the bot stops answering and account connections are undone. |
users​
| Tool | Kind | Scope | Permission | Endpoint | What it does |
|---|---|---|---|---|---|
kadu_users_list | read | kadu/users + read | agent.users.list | GET /v1/users | Lists the members of the organization (up to 100). |
memberships​
| Tool | Kind | Scope | Permission | Endpoint | What it does |
|---|---|---|---|---|---|
kadu_memberships_list | read | kadu/memberships + read | agent.memberships.list | GET /v1/memberships | Lists the memberships: which user holds which role in the organization. |
roles​
| Tool | Kind | Scope | Permission | Endpoint | What it does |
|---|---|---|---|---|---|
kadu_roles_list | read | kadu/roles + read | agent.roles.list | GET /v1/roles | Lists the roles and the permissions each one grants (agent.<resource>.<action>). |
kadu_roles_create | write | kadu/roles + write | agent.roles.create | POST /v1/roles | Creates a role. |
The fields of each resource are in the API reference.
A tool you cannot run is not listed by tools/list at all. If one from this page is missing, see Authentication.