Organizations and team
The organization, its members and invitations, notification settings and the AI usage summary.
| Method | Path | Needs | Returns |
|---|---|---|---|
| GET | /organizations | authenticated | the organizations you belong to |
| GET | /organizations/current | organization.read | organization, your role, entitlements |
| GET | /organizations/current/members | organization.read | { items: [{ userId, email, role, joinedAt, isYou }] } |
| PATCH | /organizations/current/members/:userId | members.manage | { role }, never above your own |
| DELETE | /organizations/current/members/:userId | members.manage | 204; the last owner cannot go |
| POST | /organizations/current/members/leave | organization.read | 204 |
| GET | /organizations/current/invitations | members.manage | PENDING, ACCEPTED, REVOKED, EXPIRED |
| POST | /organizations/current/invitations | members.manage | 201 { email, role }; seats are members plus pending |
| DELETE | /organizations/current/invitations/:id | members.manage | 204, revoke |
| GET | /invitations/preview?token= | public | { organizationName, role, emailHint, status, expiresAt } |
| POST | /invitations/accept | authenticated | { token }; the signed-in email must match |
| GET | /organizations/current/notifications | organization.read | instantEmail, digestFrequency, slackWebhook (masked) |
| PATCH | /organizations/current/notifications | organization.manage | any of the three; the webhook must be https |
| POST | /organizations/current/notifications/test | organization.manage | posts a test message → { ok, error } |
| GET | /organizations/current/ai-usage | organization.read | provider, window, limits, reserved and settled per site |
Something here wrong, missing or out of date? Tell us and we will fix the page.