The Workspace settings page is the central control panel for your Causeloop workspace. Changes here affect every member of the workspace. You need the Workspace Admin (tenant_admin) role or the workspace:write scope to save changes.
Open it from the sidebar: Settings → Workspace.
General
| Field | Description |
|---|
| Name | Display name shown in the header and emails. 2–100 characters. |
| Slug | URL-safe identifier used in API paths and share links. Lowercase alphanumeric + hyphens, 1–60 characters, must start and end with alphanumeric. |
| Description | Optional summary of the workspace purpose. Max 2,000 characters. |
| Industry | Sector tag used for benchmark comparisons (e.g. FinTech, Software). |
| Timezone | Default IANA timezone for scheduled reports and digest emails (e.g. America/New_York). Members can override their own timezone in Account settings. |
| Theme | Default colour theme — light or dark. Members can override this individually. |
Changing the slug updates all shareable links that include it. Existing direct API calls using the workspace ID are not affected.
Plan and usage
The Plan card is read-only and shows:
- Current plan tier (
free, growth, enterprise)
- Seats used / total seats available
- API calls used / limit this billing period
- Storage used / limit
- Renewal date
- A link to the Causeloop billing portal
To upgrade your plan or purchase additional seats, click Manage billing — it opens the billing portal in a new tab.
AI settings
These settings tune how Causeloop’s intelligence layer behaves across the workspace.
| Field | Description |
|---|
| Auto-link issues | When enabled, Causeloop automatically links new issues to existing patterns it detects as related. |
| Confidence threshold | Minimum AI confidence score (0.0–1.0) required to auto-link an issue or surface a recommendation. Higher values mean fewer but higher-confidence signals. |
| Proof window (days) | Number of days (7–365) after a recommendation is closed that Causeloop monitors for recurrence to confirm the fix held. |
| Auto recommendations | Causeloop surfaces fix recommendations automatically as patterns mature. |
| Predictive alerts | Send alerts when Causeloop predicts a pattern is likely to recur. |
| Anonymize PII in AI | Strip personally identifiable information from text before it is sent to AI models. |
| Cross-workspace benchmarking | Allow anonymised aggregate metrics to contribute to cross-tenant benchmarks. |
sso_enforced (require SSO for all sign-ins) is an Enterprise-only feature. Enabling it on a non-Enterprise plan returns 422 sso_requires_enterprise.
Saving changes
Click Save at the bottom of the form. The UI sends PATCH /v1/workspace with only the fields that changed.
curl -X PATCH "https://api.causeloop.ai/v1/workspace" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Platform Engineering",
"timezone": "America/Chicago",
"ai_confidence_threshold": 0.85
}'
200 response returns the full updated workspace object. Errors:
| Status | Code | Condition |
|---|
409 | slug_taken | Another workspace already uses that slug |
422 | sso_requires_enterprise | SSO enforcement requires Enterprise plan |
422 | validation_error | A field value violates its constraint |
For the full REST specification see API Reference → Workspace Settings. 
