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

# Workspace Settings: API Keys, Retention, and Alerts

> Control your workspace name, timezone, data retention, API keys, and notifications — everything that defines how your Cano environment behaves.

Workspace settings are the foundation of your Cano Analytics environment. From here you control how your workspace is identified, how long your data is stored, who can access the API, and what alerts keep you informed when something goes wrong. Changes you make here apply to every member of your workspace.

## General

The **General** section lets you update the basic identity and display preferences for your workspace.

* **Workspace Name** — The name shown in the top navigation bar and in all email notifications. Choose a name that clearly identifies the project or organization.
* **Display Timezone** — All dashboards, reports, and event timestamps are rendered in this timezone. Select the timezone that matches your primary team or user base.
* **Date Format** — Choose between `MM/DD/YYYY`, `DD/MM/YYYY`, or `YYYY-MM-DD` to match the convention your team uses across reports.

To save changes, click **Save General Settings** at the bottom of the section.

***

## API Keys

API keys authenticate your servers, SDKs, and third-party integrations with Cano Analytics. Every key is tied to a **scope** that limits what it can do.

### Key Scopes

| Scope   | Permissions                                                     |
| ------- | --------------------------------------------------------------- |
| `read`  | Query events, dashboards, and reports only                      |
| `write` | Track events and call `identify` — no read access to reports    |
| `admin` | Full access: read, write, manage workspace settings and members |

<Tip>
  Use **write-scoped** keys in your client SDKs and front-end applications — they can send data but cannot expose sensitive reports. Reserve **admin keys** for secure server environments only, and never commit them to source control.
</Tip>

### Listing Your Keys

Navigate to **Settings → API Keys** to see all active keys, including their scope, creation date, and the last time each key was used.

### Creating a New Key

<Steps>
  <Step title="Open API Keys settings">
    Go to **Settings → API Keys** and click **Create New Key**.
  </Step>

  <Step title="Name and scope the key">
    Enter a descriptive name (e.g., `production-backend`) and select the appropriate scope: **read**, **write**, or **admin**.
  </Step>

  <Step title="Copy the key immediately">
    Your new key is displayed **once**. Copy it to a secure location such as a secrets manager — it will not be shown again.
  </Step>
</Steps>

### Revoking a Key

Click the **Revoke** button next to any key in the list. Revocation is immediate — any service using that key will lose access instantly. Create a replacement key before revoking if you need to rotate credentials with zero downtime.

***

## Data Retention

Data retention controls how long raw event data is stored before it is permanently deleted. Aggregated dashboard metrics are not affected by retention settings.

| Retention Period | Available On |
| ---------------- | ------------ |
| 30 days          | Free         |
| 90 days          | Starter      |
| 1 year           | Pro          |
| Unlimited        | Enterprise   |

To change your retention period, go to **Settings → Data Retention**, select the period you want, and click **Save**. If your current plan does not support a longer retention period, you will be prompted to upgrade.

<Warning>
  Shortening your retention period permanently deletes events older than the new limit. This action cannot be undone. Make sure you have exported any historical data you need before reducing retention.
</Warning>

***

## Notifications

Cano Analytics can send email alerts to workspace admins when something requires attention.

* **Sync Failures** — Get notified when a data source connection fails or an ingestion job produces errors.
* **Data Anomalies** — Receive an alert when event volume drops or spikes significantly compared to recent baselines.

To configure notifications, go to **Settings → Notifications**, toggle the alerts you want to enable, and ensure the recipient email addresses are up to date. Alerts are sent to all workspace members with the **Admin** or **Owner** role by default; you can add or remove individual addresses in the notification preferences panel.

***

## Danger Zone

The Danger Zone contains irreversible actions that affect your entire workspace.

* **Reset Workspace Data** — Deletes all events, dashboards, and data sources while keeping your workspace configuration and team members intact.
* **Delete Workspace** — Permanently deletes the workspace and all of its data, including member access, API keys, and every stored event.

<Warning>
  Both actions in the Danger Zone are **permanent and irreversible**. Deleted data cannot be recovered by Cano Analytics support. If you are unsure, export your data first or contact [support@canoanalytics.io](mailto:support@canoanalytics.io) before proceeding.
</Warning>

To perform either action, click the corresponding button, type the workspace name to confirm, and click the final confirmation button.

***

## Related Pages

<CardGroup cols={2}>
  <Card title="Team & Permissions" icon="users" href="/docs/settings/team-and-permissions">
    Invite teammates and control role-based access to your workspace.
  </Card>

  <Card title="Billing" icon="credit-card" href="/docs/settings/billing">
    Manage your subscription plan, usage limits, and payment details.
  </Card>
</CardGroup>