---
title: "Update the organisation"
method: PUT
path: "/api/organisations"
tags: ["Organisation"]
---

# Update the organisation

`PUT /api/organisations`

Updates the organisation name, display name, and preferences.

## Request body

- object
  - `name` string — URL-safe name of the organisation
  - `displayName` string — Display name of the organisation
  - `preferences` object — Organisation preferences to update
    - `themeLogo` string — URL or path to the organisation logo
    - `themePrimaryColor` string — Primary theme color for the organisation
    - `emailSignupDomains` string — Comma separated list

## Response `200`

The updated organisation

- object — The updated organisation
  - `id` string, required — Unique identifier of the organisation
  - `name` string, required — URL-safe name of the organisation
  - `displayName` string, required — Display name of the organisation
  - `onboarded` boolean, required — Whether the organisation has completed onboarding
  - `license` string — License key
  - `licenseData` object — Decoded license data
    - `kind` 'online' | 'offline' | 'null', nullable — License kind (online or offline)
    - `createdAt` string, nullable — Date the license was created
    - `expiresAt` string, nullable — Date the license expires
    - `environmentState` 'initial' | 'connected' | 'disabled', required — Current environment state
    - `organisationStatus` 'active' | 'disabled' | 'invalid' | 'grace' | 'expired', required — Current organisation license status
    - `environmentLimits` object — Environment feature limits and flags
      - `users` number — Maximum number of users allowed
      - `projects` number — Maximum number of projects allowed
      - `documents` number — Maximum number of documents allowed
      - `deployments` number — Maximum number of deployments allowed
      - `enableDeploymentsWorkflows` boolean — Whether deployment workflows are enabled
      - `enableSSO` boolean — Whether SSO is enabled
      - `enableAuditLogs` boolean — Whether audit logs are enabled
      - `enableBranding` boolean — Whether custom branding is enabled
      - `evaluateByRelease` boolean — Whether evaluate by release is enabled
      - `diffModel` boolean — Whether model diffing is enabled
      - `diffRelease` boolean — Whether release diffing is enabled
      - `activeSimulation` boolean — Whether active simulation is enabled
      - `testEventsShared` boolean — Whether test events sharing is enabled
      - `enableLLM` boolean — Whether LLM features are enabled
      - `enableRoles` boolean — Whether roles are enabled
  - `url` string — URL of the organisation
  - `themeLogo` string, required — Theme logo URL
  - `themePrimaryColor` string, required — Theme primary color
  - `preferences` object, required — Organisation preferences
    - `emailSignupDomains` string — Comma-separated list of email signup domains
    - `themePrimaryColor` string — Primary theme color for the organisation
    - `themeLogo` string — URL or path to the organisation logo
  - `createdAt` string, required — Creation timestamp
  - `updatedAt` string, required — Last update timestamp
  - `deletedAt` string — Deletion timestamp if soft-deleted

---

[API](https://skmtc.dev/gorules/apis/gorules-agent-api.md) · [All operations](https://skmtc.dev/gorules/apis/gorules-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gorules/gorules-agent-api/revisions/52c0773fcd80/schema)