Reference

Settings

Settings is where you configure your organisation as a whole and secure your own account: the organisation profile and governance defaults, your subscription, account security, single sign-on, and personal API tokens. Most organisation-wide sections are owner-gated; the security section is always about your own login.

Organisation

The Organisation page holds the settings that apply to everyone in the workspace. You can edit the organisation's name and pick its timezone from the grouped IANA list (UTC by default). The timezone is more than display polish. It drives when scheduled work is considered due and how times are shown across the app.

Two controls here shape governance directly:

The same page carries Providers & data controls: the allow-list of model providers your agents may use, an opt-out flag for provider data retention (zero-retention), and the retention windows for run history and audit logs. Retention is bounded. There is a compliance floor you cannot go below and a plan-derived ceiling you cannot exceed.

The organisation's slug is shown but is immutable; it cannot be changed here.

The whole Organisation page sits behind the tenant.manage permission — owner-only in the standard role matrix. Changes are saved through an audited action, so adjustments to the 2FA requirement, segregation rule, providers and retention all leave a trail.

Billing & subscription

Billing shows your current plan, subscription status and trial state, plus usage against your plan's limits. The change-plan flow, payment methods and invoices are handled through Stripe.

The key actions:

The usage meters you see (seats, workers, integrations, governed repositories, runs, actions) come from the same evaluation point that enforcement reads, so what's displayed is exactly what the limits act on. You are never shown a token or raw-cost gauge. A trialling organisation that has never checked out has no billing account yet, so the page explains that rather than offering a portal link that would fail. If a trial ends without a valid subscription, usage is locked until you subscribe. Billing and checkout stay reachable so you can unlock it.

Billing actions require the billing.manage permission. If Stripe is slow or unreachable, invoices and renewal dates degrade gracefully to empty rather than breaking the page.

Account security

Unlike the organisation-wide pages, Security is about your own account. From here you can:

Session listing and per-device revocation are available when the database session store is in use; otherwise that section is hidden. Raw session identifiers never reach your browser, only a hashed reference used for the revoke action. The Security page (and the revoke action) are protected by a password re-confirmation step.

Single sign-on

Single sign-on (SSO) lets your identity provider (IdP) mint sessions into the organisation, and lets a SCIM bearer token write your directory. You can configure one or more connections using SAML or OIDC, enable or disable them, edit their attribute and role maps, and issue or revoke SCIM tokens for provisioning.

Each connection summary gives you the URLs to paste into your IdP console, along with the login URL. For SAML that means the ACS URL, metadata URL and SP entity ID; for OIDC the callback URL. Public fields (endpoints, certificates, client IDs) are shown so you can edit without re-typing. Secrets are write-only: an OIDC client secret or SAML private key is reported only as "configured" and is never echoed back; leaving a secret blank when editing keeps the stored value.

Role mapping can resolve a group claim to any role except owner — a group claim can never escalate to owner. A freshly issued or rotated SCIM token is shown exactly once, immediately after creation; copy it then, because it cannot be retrieved again.

SSO is owner-gated via the sso.manage permission, and it is a plan entitlement. If your plan doesn't include SSO, the page shows a clear upgrade prompt naming the tier you'd need rather than a form that would silently fail.

API tokens

API tokens are personal access tokens you create for the organisation you're currently acting in, for scripts and integrations that call the API. You give a token a name and choose its abilities from the permission groups you actually hold here; a token is a delegation of your own authority and can never grant more than you have.

Expiry is mandatory: tokens default to 90 days and may live at most 365 days. The plaintext token is displayed only once, right after creation. Copy it then, because afterwards only its hash is stored. The list shows each token's abilities, last-used and created times, expiry, and whether it has expired; revoke any token from here.

Tokens are scoped to a single organisation, so the abilities offered and the tokens listed are always for your current workspace. If your membership is removed, or a role change strips an ability a live token carries, the affected tokens are automatically revoked.

Next steps