Organization

Your organization's profile, domains, setup progress, shared storage and settings. These endpoints act on the caller's own organization.

📄️Get setup status

Returns the company setup checklist for the caller's organization: whether it is shown and each step's status. Only an Org Owner or Org Admin of a customer organization sees the steps; anyone else gets `visible` false.

📄️Get shared storage

Returns the caller's organization's shared storage, where shared agent accounts keep their login so several nodes can run them, or null when none is set up. Requires permission to view credentials.

📄️Update shared storage

Creates or updates the organization's shared storage settings: cloud credential, region, subnet and allowed CIDR; a change to anything but the CIDR resets `status` to `pending` for the next provisioning run. Once the file system exists only the CIDR can change, and any other change returns 409. Requires permission to edit credentials, and returns 403 until Jaah enables shared storage for the organization.

📄️Provision shared storage

Runs one provisioning pass for the organization's shared storage and returns it with its `status`: `ready`, `provisioning` (call again) or `failed` with `last_error`. Returns 409 while another pass is running, 404 when nothing is set up, and 403 until Jaah enables shared storage for the organization. Requires permission to edit credentials.

📄️Get organization

Returns one organization with its slug, name, description, enabled state, member count and default role. Requires the Org Owner or Org Admin role, and only the caller's own organization is readable; any other returns 404.

📄️Update organization

Updates only the organization fields sent; omitted fields stay unchanged. Requires the Org Owner or Org Admin role, which may change only the caller's own organization's default role and SSO settings; any other field returns 403 and nothing is saved.

📄️Get minimum schedule period

Returns the shortest interval, in seconds, at which any schedule in the organization may run (`effective`), with the Jaah-set minimum the organization may not go below (`upstream`) and the organization's own value (`own`). Requires the Org Owner or Org Admin role.

📄️Set minimum schedule period

Sets, or clears with `null`, the organization's own minimum schedule interval `own`, in seconds, between the Jaah-set minimum (`upstream`) and 86400; a value outside that range returns 422. Existing schedules are not edited: one running faster is throttled when it fires. Requires the Org Owner or Org Admin role.

📄️List organization domains

Lists the email domains registered to the organization, alphabetically, with who added each and when. People with an address on these domains may join the organization. Requires the Org Owner or Org Admin role.

📄️Get settings

Returns the organization-level settings that apply to the caller's organization with their resolved values, plus the app title and whether the caller may edit them. Requires permission to view system settings.

📄️Get legal preview

Returns one public legal page (terms, privacy, security, subprocessors or dpa) as the operator will publish it: its title, content blocks and last-updated date, whether it is still a draft, and which Settings > Legal values are still unset. Operators only; returns 404 for an unknown page.