# workspaces

> Businesses: profile, settings, business hours and limits.

Businesses: profile, settings, business hours and limits.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/workspaces` | `workspaces_list`: List the Businesses (workspaces) of the org | `org:read` | - |
| POST | `/v1/workspaces` | `workspaces_create`: Create a Business (workspace) | `org:write` | - |
| DELETE | `/v1/workspaces/{workspace_id}` | `workspaces_delete`: Delete a Business (disconnects channels, 30-day grace) | `org:write` | - |
| GET | `/v1/workspaces/{workspace_id}` | `workspaces_get`: Get a Business | `org:read` | yes |
| PATCH | `/v1/workspaces/{workspace_id}` | `workspaces_update`: Update a Business (profile, timezone, language, greeting/away, AI disclosure, brand voice, logo) | `org:write` | - |
| GET | `/v1/workspaces/{workspace_id}/business-hours` | `workspaces_get_business_hours`: Business hours and holidays | `org:read` | - |
| PUT | `/v1/workspaces/{workspace_id}/business-hours` | `workspaces_replace_business_hours`: Replace business hours and holidays | `org:write` | - |
| GET | `/v1/workspaces/{workspace_id}/limits` | `workspaces_get_limits`: Effective entitlements and usage for this Business | `org:read` | - |
| GET | `/v1/workspaces/{workspace_id}/settings` | `workspaces_get_settings`: Settings document (inbox, routing, SLA, quick replies, AI policy, consent rules, retention) | `org:read` | - |
| PATCH | `/v1/workspaces/{workspace_id}/settings` | `workspaces_update_settings`: Update the settings document | `org:write` | - |

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