# orgs

> Accounts, agency client orgs and access grants.

Accounts, agency client orgs and access grants.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| POST | `/v1/orgs` | `orgs_create`: Create an org (account) or, for agencies, a child client org | `any` | - |
| DELETE | `/v1/orgs/{org_id}` | `orgs_close`: Close the account (30-day grace, then crypto-shred) | `org:write` | - |
| GET | `/v1/orgs/{org_id}` | `orgs_get`: Get an org (the caller's own org, or one of an agency's client orgs) | `org:read` | yes |
| PATCH | `/v1/orgs/{org_id}` | `orgs_update`: Update the org (name, billing identity, address, white-label branding) | `org:write` | - |
| GET | `/v1/orgs/{org_id}/access-grants` | `orgs_list_access_grants`: Agency: list client-org access grants | `members:read` | - |
| POST | `/v1/orgs/{org_id}/access-grants` | `orgs_create_access_grant`: Agency: grant a staff member access to a client org | `members:write` | - |
| DELETE | `/v1/orgs/{org_id}/access-grants/{grant_id}` | `orgs_revoke_access_grant`: Agency: revoke a client-org access grant | `members:write` | - |
| GET | `/v1/orgs/{org_id}/clients` | `orgs_list_clients`: Agency: list client orgs | `org:read` | - |
| POST | `/v1/orgs/{org_id}/clients` | `orgs_create_client`: Agency: create a client org with its first workspace | `org:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
