Update organization | Comp AI API

Partially updates the authenticated organization. Only provided fields will be updated.

PATCH /v1/organization

Update organization

cURL

curl --request PATCH \
  --url https://api.trycomp.ai/v1/organization \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "New Acme Corporation",
  "slug": "new-acme-corp",
  "logo": "https://example.com/logo.png",
  "metadata": "{\"theme\": \"dark\", \"preferences\": {}}",
  "website": "https://acme-corp.com",
  "onboardingCompleted": true,
  "hasAccess": true,
  "fleetDmLabelId": 123,
  "isFleetSetupCompleted": false,
  "primaryColor": "#3B82F6",
  "advancedModeEnabled": false,
  "backgroundCheckStepEnabled": true
}
'

200

{
  "id": "org_abc123def456",
  "name": "New Acme Corporation",
  "slug": "new-acme-corp",
  "logo": "https://example.com/logo.png",
  "metadata": "{\"theme\": \"dark\", \"preferences\": {}}",
  "website": "https://acme-corp.com",
  "onboardingCompleted": true,
  "hasAccess": true,
  "fleetDmLabelId": 123,
  "isFleetSetupCompleted": false,
  "primaryColor": "#3B82F6",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

apikeyoauth2

X-API-Key · string · header · required

API key for authentication

Body

application/json

Organization update data

name · string

Organization name

Example:

"New Acme Corporation"

slug · string

Organization slug

Example:

"new-acme-corp"

logo · string

Organization logo URL

Example:

"https://example.com/logo.png"

metadata · string

Additional metadata in JSON format

Example:

"{\"theme\": \"dark\", \"preferences\": {}}"

website · string

Organization website URL

Example:

"https://acme-corp.com"

onboardingCompleted · boolean

Whether onboarding is completed

Example:

true

hasAccess · boolean

Whether organization has access to the platform

Example:

true

fleetDmLabelId · integer

FleetDM label ID for device management

Example:

123

isFleetSetupCompleted · boolean

Whether FleetDM setup is completed

Example:

false

primaryColor · string

Organization primary color in hex format

Example:

"#3B82F6"

advancedModeEnabled · boolean

Whether advanced mode is enabled for the organization

Example:

false

backgroundCheckStepEnabled · boolean

Whether the background-check step is required during member onboarding. Set to false to turn off the "Require background checks" setting; true to require it.

Example:

true

Response

200

application/json

Organization updated successfully

id · string

The organization ID

Example:

"org_abc123def456"

name · string

Organization name

Example:

"New Acme Corporation"

slug · string

Organization slug

Example:

"new-acme-corp"

logo · string | null

Organization logo URL

Example:

"https://example.com/logo.png"

metadata · string | null

Additional metadata in JSON format

Example:

"{\"theme\": \"dark\", \"preferences\": {}}"

website · string | null

Organization website URL

Example:

"https://acme-corp.com"

onboardingCompleted · boolean

Whether onboarding is completed

Example:

true

hasAccess · boolean

Whether organization has access to the platform

Example:

true

fleetDmLabelId · integer | null

FleetDM label ID for device management

Example:

123

isFleetSetupCompleted · boolean

Whether FleetDM setup is completed

Example:

false

primaryColor · string | null

Organization primary color in hex format

Example:

"#3B82F6"

createdAt · string<date-time>

When the organization was created

authType · enum<string>

How the request was authenticated

Available options: api-key, session