@devries-cameron20 / composio Mirror · read-only / commits / e68f445c1
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 09:45 UTC

docs(kb): document what each org role can do (#4851)

## Summary - Adds a "What each organization role can do" section to the Organization Members KB guide (renamed "Organization Members and Roles"), closing PRDE-1777. - Explains that **Member** (For You settings) and **Developer** (Platform settings) are the same org-wide role. - Separate For You and Platform tables for Admin / Member (Developer) / Viewer. Org management (members, billing, SSO) is called out once as Admin-only. - Every row is backed by the current server gate: Apollo Casbin policy `apps/apollo/src/lib/rbac/model.ts`, admin-only project create/delete and API-key routes, admin-only project config, creator-only shared connections, and For You being hidden for Viewers in the dashboard. - Source, generated article, manifest entry, and generated MDX updated together, following recent in-repo KB edits. ## Validation - `bun run check:kb`: pass (124 published, 0 held). - `bun run test`: 626 pass, 0 fail. - `bun run types:check`: pass. - `bun run check:kb-semantic --allow-stale` (the CI mode): pass with the expected stale-hash warning. - `git diff --check`: clean. ## Visual verification - Local docs dev server (`localhost:3077/kb/guide/dashboard-org-members`), desktop 1383×868, dark theme. - Intro and For You table: ![Roles intro and Composio For You table](https://github.com/user-attachments/assets/5d14115c-e5b1-4e7c-9cc9-1e793ca3a246) - Platform table: ![Composio Platform roles table](https://github.com/user-attachments/assets/882900db-94ef-4d31-8ccc-5afa0f621c12) ## Known verification limitations - The KB semantic artifact isn't rebuilt (needs `OPENAI_API_KEY`). Search falls back to keyword results until the "Docs - Rebuild KB Semantic Artifact" workflow runs. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Kshitij Jhunjhunwala committed Oct 15, 2026 at 07:52 UTC e68f445c15ed4b959fd7fd3889050e3f98e93b85
4 files changed +150 -13
docs/content/kb/guide/dashboard-org-members.mdx
+48 -5
@@ -1,14 +1,57 @@
1 ---
2 -title: "Organization Members and Administrators"
3 -description: "Public guidance for transferring organization control and managing administrator roles."
4 -keywords: ["dashboard","members","organizations","platform","roles","account-and-billing","getting-started","/kb/dashboard-and-projects/transfer-organization-control-to-another-user","transfer-organization-control-to-another-user"]
5 -sources: [{"sourcePath":"dashboard/org-members/public.md","sourceHeading":"Transfer organization control to another user"}]
6 -lastVerifiedAt: "2026-08-17"
2 +title: "Organization Members and Roles"
3 +description: "What the Admin, Member (Developer), and Viewer roles can do in Composio For You and Platform, and how to transfer organization control."
4 +keywords: ["dashboard","for-you","members","organizations","permissions","platform","roles","account-and-billing","getting-started","/kb/dashboard-and-projects/transfer-organization-control-to-another-user","transfer-organization-control-to-another-user"]
5 +sources: [{"sourcePath":"dashboard/org-members/public.md","sourceHeading":"What each organization role can do"},{"sourcePath":"dashboard/org-members/public.md","sourceHeading":"Transfer organization control to another user"}]
6 +lastVerifiedAt: "2026-10-13"
7 reviewAfter: "2026-11-15"
8 freshness: "evergreen"
9 topics: ["account-and-billing","getting-started"]
10 aliases: ["/kb/dashboard-and-projects/transfer-organization-control-to-another-user","transfer-organization-control-to-another-user"]
11 ---
12 +## What each organization role can do
13 +
14 +Every member of your organization has one of three roles: **Admin**, **Member**, or **Viewer**. The role applies to the whole organization, so it covers both Composio For You and Platform.
15 +
16 +**Member** and **Developer** are the same role. The For You **Members** settings page calls it **Member**, and the Platform **Team Members** settings page calls it **Developer**. If you change someone's role on either page, it changes in both products.
17 +
18 +Only Admins can manage the organization itself, in both products:
19 +
20 +- Invite people, create invite links, change roles, and remove members.
21 +- Manage billing, plans, and wallet top-ups.
22 +- Rename or delete the organization, and set up SSO.
23 +
24 +### Composio For You
25 +
26 +| Action | Admin | Member | Viewer |
27 +|---|---|---|---|
28 +| Open For You | Yes | Yes | No |
29 +| Connect your own apps | Yes | Yes | No |
30 +| Use connections an admin or teammate shared with the organization | Yes | Yes | No |
31 +| Share one of your connections with the organization | Yes | Yes | No |
32 +| Rename, reconnect, unshare, or delete a shared connection | Only the person who shared it | Only the person who shared it | No |
33 +| Turn Instant Tools on or off for the organization | Yes | No | No |
34 +| See tool logs for the whole organization | Yes | Own activity only | No |
35 +
36 +Viewers can't use For You at all. Give your team the **Member** role if they need to connect their own apps or use shared connections.
37 +
38 +Members only see and manage their own personal connections. Only the person who shared a connection can rename, reconnect, unshare, or delete it. Admins can't change a teammate's shared connection either.
39 +
40 +### Composio Platform
41 +
42 +| Action | Admin | Developer | Viewer |
43 +|---|---|---|---|
44 +| View projects, logs, and settings | Yes | Yes | Yes |
45 +| Connect apps and manage connected accounts in a project | Yes | Yes | No |
46 +| Create, edit, enable, or delete auth configs | Yes | Yes | No |
47 +| Manage triggers, webhook subscriptions, and custom toolkits | Yes | Yes | No |
48 +| Rename a project | Yes | Yes | No |
49 +| Create or delete a project | Yes | No | No |
50 +| Create or revoke project API keys and set IP allowlists | Yes | No | No |
51 +| Change project security settings, such as 2FA, required MCP API keys, data masking, and log visibility | Yes | No | No |
52 +
53 +Developers can build inside existing projects. Ask an Admin to create a project or to issue an API key for it.
54 +
55 ## Transfer organization control to another user
56
57 Transfer organization control by assigning the **Admin** role:
docs/kb/articles/dashboard-org-members.md
+43
@@ -1,3 +1,46 @@
1 +## What each organization role can do
2 +
3 +Every member of your organization has one of three roles: **Admin**, **Member**, or **Viewer**. The role applies to the whole organization, so it covers both Composio For You and Platform.
4 +
5 +**Member** and **Developer** are the same role. The For You **Members** settings page calls it **Member**, and the Platform **Team Members** settings page calls it **Developer**. If you change someone's role on either page, it changes in both products.
6 +
7 +Only Admins can manage the organization itself, in both products:
8 +
9 +- Invite people, create invite links, change roles, and remove members.
10 +- Manage billing, plans, and wallet top-ups.
11 +- Rename or delete the organization, and set up SSO.
12 +
13 +### Composio For You
14 +
15 +| Action | Admin | Member | Viewer |
16 +|---|---|---|---|
17 +| Open For You | Yes | Yes | No |
18 +| Connect your own apps | Yes | Yes | No |
19 +| Use connections an admin or teammate shared with the organization | Yes | Yes | No |
20 +| Share one of your connections with the organization | Yes | Yes | No |
21 +| Rename, reconnect, unshare, or delete a shared connection | Only the person who shared it | Only the person who shared it | No |
22 +| Turn Instant Tools on or off for the organization | Yes | No | No |
23 +| See tool logs for the whole organization | Yes | Own activity only | No |
24 +
25 +Viewers can't use For You at all. Give your team the **Member** role if they need to connect their own apps or use shared connections.
26 +
27 +Members only see and manage their own personal connections. Only the person who shared a connection can rename, reconnect, unshare, or delete it. Admins can't change a teammate's shared connection either.
28 +
29 +### Composio Platform
30 +
31 +| Action | Admin | Developer | Viewer |
32 +|---|---|---|---|
33 +| View projects, logs, and settings | Yes | Yes | Yes |
34 +| Connect apps and manage connected accounts in a project | Yes | Yes | No |
35 +| Create, edit, enable, or delete auth configs | Yes | Yes | No |
36 +| Manage triggers, webhook subscriptions, and custom toolkits | Yes | Yes | No |
37 +| Rename a project | Yes | Yes | No |
38 +| Create or delete a project | Yes | No | No |
39 +| Create or revoke project API keys and set IP allowlists | Yes | No | No |
40 +| Change project security settings, such as 2FA, required MCP API keys, data masking, and log visibility | Yes | No | No |
41 +
42 +Developers can build inside existing projects. Ask an Admin to create a project or to issue an API key for it.
43 +
44 ## Transfer organization control to another user
45
46 Transfer organization control by assigning the **Admin** role:
docs/kb/manifest.json
+10 -4
@@ -318,10 +318,14 @@
318 },
319 {
320 "slug": "dashboard-org-members",
321 - "title": "Organization Members and Administrators",
322 - "description": "Public guidance for transferring organization control and managing administrator roles.",
321 + "title": "Organization Members and Roles",
322 + "description": "What the Admin, Member (Developer), and Viewer roles can do in Composio For You and Platform, and how to transfer organization control.",
323 "articlePath": "dashboard-org-members.md",
324 "sources": [
325 + {
326 + "sourcePath": "dashboard/org-members/public.md",
327 + "sourceHeading": "What each organization role can do"
328 + },
329 {
330 "sourcePath": "dashboard/org-members/public.md",
331 "sourceHeading": "Transfer organization control to another user"
@@ -333,8 +337,10 @@
337 ],
338 "tags": [
339 "dashboard",
340 + "for-you",
341 "members",
342 "organizations",
343 + "permissions",
344 "platform",
345 "roles"
346 ],
@@ -344,8 +350,8 @@
350 ],
351 "relatedGuides": [],
352 "externalResources": [],
347 - "updatedAt": "2026-07-16",
348 - "lastVerifiedAt": "2026-08-17",
353 + "updatedAt": "2026-10-13",
354 + "lastVerifiedAt": "2026-10-13",
355 "reviewAfter": "2026-11-15",
356 "freshness": "evergreen",
357 "state": "published",
docs/kb/source/dashboard/org-members/public.md
+49 -4
@@ -1,17 +1,62 @@
1 ---
2 type: "guide"
3 -title: "Organization Members and Administrators"
4 -description: "Public guidance for transferring organization control and managing administrator roles."
3 +title: "Organization Members and Roles"
4 +description: "What the Admin, Member (Developer), and Viewer roles can do in Composio For You and Platform, and how to transfer organization control."
5 category: "getting-started"
6 visibility: "public"
7 -timestamp: "2026-07-16T00:00:00Z"
7 +timestamp: "2026-10-13T00:00:00Z"
8 tags:
9 - "dashboard"
10 - "organizations"
11 - "members"
12 - "roles"
13 + - "permissions"
14 + - "for-you"
15 ---
14 -# Organization Members and Administrators
16 +# Organization Members and Roles
17 +
18 +## What each organization role can do
19 +
20 +Every member of your organization has one of three roles: **Admin**, **Member**, or **Viewer**. The role applies to the whole organization, so it covers both Composio For You and Platform.
21 +
22 +**Member** and **Developer** are the same role. The For You **Members** settings page calls it **Member**, and the Platform **Team Members** settings page calls it **Developer**. If you change someone's role on either page, it changes in both products.
23 +
24 +Only Admins can manage the organization itself, in both products:
25 +
26 +- Invite people, create invite links, change roles, and remove members.
27 +- Manage billing, plans, and wallet top-ups.
28 +- Rename or delete the organization, and set up SSO.
29 +
30 +### Composio For You
31 +
32 +| Action | Admin | Member | Viewer |
33 +|---|---|---|---|
34 +| Open For You | Yes | Yes | No |
35 +| Connect your own apps | Yes | Yes | No |
36 +| Use connections an admin or teammate shared with the organization | Yes | Yes | No |
37 +| Share one of your connections with the organization | Yes | Yes | No |
38 +| Rename, reconnect, unshare, or delete a shared connection | Only the person who shared it | Only the person who shared it | No |
39 +| Turn Instant Tools on or off for the organization | Yes | No | No |
40 +| See tool logs for the whole organization | Yes | Own activity only | No |
41 +
42 +Viewers can't use For You at all. Give your team the **Member** role if they need to connect their own apps or use shared connections.
43 +
44 +Members only see and manage their own personal connections. Only the person who shared a connection can rename, reconnect, unshare, or delete it. Admins can't change a teammate's shared connection either.
45 +
46 +### Composio Platform
47 +
48 +| Action | Admin | Developer | Viewer |
49 +|---|---|---|---|
50 +| View projects, logs, and settings | Yes | Yes | Yes |
51 +| Connect apps and manage connected accounts in a project | Yes | Yes | No |
52 +| Create, edit, enable, or delete auth configs | Yes | Yes | No |
53 +| Manage triggers, webhook subscriptions, and custom toolkits | Yes | Yes | No |
54 +| Rename a project | Yes | Yes | No |
55 +| Create or delete a project | Yes | No | No |
56 +| Create or revoke project API keys and set IP allowlists | Yes | No | No |
57 +| Change project security settings, such as 2FA, required MCP API keys, data masking, and log visibility | Yes | No | No |
58 +
59 +Developers can build inside existing projects. Ask an Admin to create a project or to issue an API key for it.
60
61 ## Transfer organization control to another user
62