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

# Manage tenant settings

> Set the shared tenant timezone and register the Google Chat spaces that reconciliation runs report to.

Two settings define how your tenant behaves for everyone on it: the shared timezone and the chat spaces runs report to. Neither takes long to configure — but getting both right before your first automated run saves your team from reading timestamps in the wrong zone and having to open the app to find out whether a sync failed.

<Note>
  Confirm the active tenant before saving. Tenant settings apply to the selected tenant, not every tenant you can access.
</Note>

## Before you start

Confirm:

* You are signed in as a Tenant Admin for the tenant you want to manage.
* The active tenant shown in **Open User Settings** is correct.
* The tenant timezone is known.
* A Google Chat incoming webhook is available for each space you intend to register.

## What Tenant Settings controls

| Setting          | Use it for                                                                                    | Tenant Admin access |
| ---------------- | --------------------------------------------------------------------------------------------- | ------------------- |
| Timezone         | The tenant's default date and time interpretation for workflows, schedules, and date windows. | View and edit       |
| Notifications    | The registry of named Google Chat spaces that finished runs report to.                        | View and edit       |
| AI configuration | Provider setup for assisted workflows.                                                        | Darpan Admin only   |

## Steps

<Steps>
  <Step title="Confirm the tenant context">
    Open **Ask Darpan**. Search for **Open User Settings**.

    In **Tenant Context**, confirm the active tenant. If the wrong tenant is active, switch before continuing.
  </Step>

  <Step title="Open Tenant Settings">
    Open **Ask Darpan** again. Search for **Open Tenant Settings** and open the result.
  </Step>

  <Step title="Set the timezone">
    In **Localization**, choose **Timezone**.

    Select the timezone for the tenant and save. Use the timezone that operators expect for schedules, date windows, and review timestamps.

    This is the tenant default, not a hard rule. Anyone can set a personal timezone in **User Settings** that overrides it for their own view — see [Timezones and how dates resolve](#timezones-and-how-dates-resolve) below.
  </Step>

  <Step title="Register chat spaces">
    In **Operations**, choose **Notifications**.

    Add one entry per destination Google Chat space: a name that is unique within the tenant, and the space's incoming webhook URL. Darpan validates the URL on save and stores it encrypted — saved spaces show their name and status, never the full URL.

    Automations link to a space, and individual users pick one of these spaces as their personal default. For the end-to-end alert flow, see [Run-completion alerts](/guides/run-completion-alerts).
  </Step>

  <Step title="Verify the change">
    Return to **Open Tenant Settings** and confirm the timezone and the registered spaces. For notification changes, run a small saved reconciliation or automation test when the team needs proof that messages are delivered.
  </Step>
</Steps>

## Timezones and how dates resolve

Darpan resolves the timezone it displays and calculates in from the first of these that is set:

1. The signed-in user's preferred timezone, from **User Settings**.
2. The tenant timezone, from **Tenant Settings**.
3. The browser's own timezone.

This affects more than formatting. Run date windows and API day ranges are anchored to midnight in the resolved timezone, so two people on the same tenant with different personal timezones can produce different day boundaries for the same saved run. Set the tenant timezone to the one your operations actually run on, and treat personal overrides as a convenience for people working elsewhere.

## Share a source configuration with another tenant

An organisation running several tenants against one upstream system used to need the same credentials entered, rotated and audited separately in each. Sharing removes the duplication: one tenant owns the configuration, and named peer tenants may use it.

| Action | Effect                                                                                 |
| ------ | -------------------------------------------------------------------------------------- |
| Grant  | Adds a tenant to the configuration's peer group.                                       |
| Revoke | Removes a tenant's access from that point onward, leaving the historical grant intact. |
| List   | Shows the owning tenant, the peer tenants, and which tenants a change would affect.    |

Sharing applies to API source configurations. Ownership stays with one tenant — peers use the configuration, they do not take it over — and the credential itself is never exposed to a peer tenant, only the ability to run against it.

Check the affected-tenant list before revoking. Revoking a configuration that another tenant's runs depend on stops those runs from resolving their source.

## Troubleshooting

| Symptom                                                 | What to check                                                                                                                                                                                     |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| You cannot save tenant settings                         | Confirm you are a Tenant Admin for the active tenant. Tenant Users can view tenant data and run reconciliation but cannot edit tenant settings.                                                   |
| The wrong tenant changed                                | Switch to the intended tenant from **Open User Settings**, then review **Open Tenant Settings** again.                                                                                            |
| A space is registered but no message arrives            | Confirm the space is active and still has a webhook, and that an automation is linked to it or someone subscribed with **Notify me**. Registering a space does not by itself route any run to it. |
| A space cannot be deleted                               | An automation or an active run subscription still references it. Deactivate it instead.                                                                                                           |
| Timestamps differ between two people on the same tenant | One of them has a personal timezone set in **User Settings** that overrides the tenant default.                                                                                                   |
| AI configuration is unavailable                         | AI provider settings are Darpan Admin only. Tenant Admins manage tenant settings and tenant-owned reconciliation setup.                                                                           |
