> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uknvas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organisations

> Members, roles, invitations and API keys. Dashboard routes, called with a session token.

| Method | Path | Permission |
| - | - | - |
| POST | `/organizations` — `name, country, contactEmail?, contactPhone?, website?` | any user (max 5 owned) |
| GET | `/organizations` | your memberships |
| GET / PATCH | `/organizations/:orgId` | `org:read` / `org:update` |
| GET | `/organizations/:orgId/members` | `members:read` |
| PATCH / DELETE | `/organizations/:orgId/members/:memberId` — `role` | `members:manage` |
| GET / POST | `/organizations/:orgId/invitations` — `email, role` | `members:manage` |
| DELETE | `/organizations/:orgId/invitations/:id` | `members:manage` |
| POST | `/organizations/invitations/accept` — `token` | the invited email only |
| GET / POST | `/organizations/:orgId/api-keys` — `name, scopes[], expiresAt?` | `api_keys:read` / `api_keys:manage` |
| POST | `/organizations/:orgId/api-keys/:keyId/rotate` — `graceHours?` (0–168, default 24) | `api_keys:manage` |
| DELETE | `/organizations/:orgId/api-keys/:keyId` | `api_keys:manage` |
| GET | `/organizations/:orgId/wallets` | `wallets:read` |
| GET | `/organizations/:orgId/transactions?currency&type&product&reference&limit&cursor` | `wallets:read` |
| GET | `/organizations/:orgId/invoices`, `/invoices/:id` | `billing:read` |
| GET | `/organizations/:orgId/pricing` | `billing:read` |
| GET / POST | `/organizations/:orgId/production-access` — `note?` | sandbox only |
| POST | `/organizations/:orgId/sandbox/deposits` — `currency, amount` + `Idempotency-Key` | sandbox only, `wallets:fund` |

New organisations are **active immediately in sandbox** and **pending in
production** until GTW activates them. Each one gets NGN and USD wallets on
creation. The secret of a new API key is returned **once**, in the create
response.

## Roles

| | owner | admin | developer | finance | viewer |
| - | :-: | :-: | :-: | :-: | :-: |
| View organisation, members, wallets, billing, bookings | ✓ | ✓ | ✓ | ✓ | ✓ |
| Edit organisation, manage members | ✓ | ✓ | | | |
| Manage API keys | ✓ | ✓ | ✓ | | |
| Fund wallets | ✓ | ✓ | | ✓ | |
| Create bookings, buy gift cards (dashboard) | ✓ | ✓ | ✓ | | |
| Request production access | ✓ | ✓ | ✓ | | |

Only the owner can grant or remove `admin`. The owner cannot be removed or
demoted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.