Update organization

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,
  "fleetDmLabelId": 123,
  "isFleetSetupCompleted": false,
  "primaryColor": "#3B82F6",
  "advancedModeEnabled": false,
  "backgroundCheckStepEnabled": true,
  "evidenceApprovalEnabled": false,
  "deviceAgentStepEnabled": true,
  "securityTrainingStepEnabled": true,
  "whistleblowerReportEnabled": true,
  "accessRequestFormEnabled": true
}
'

const options = {
  method: 'PATCH',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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,
    fleetDmLabelId: 123,
    isFleetSetupCompleted: false,
    primaryColor: '#3B82F6',
    advancedModeEnabled: false,
    backgroundCheckStepEnabled: true,
    evidenceApprovalEnabled: false,
    deviceAgentStepEnabled: true,
    securityTrainingStepEnabled: true,
    whistleblowerReportEnabled: true,
    accessRequestFormEnabled: true
  })
};

fetch('https://api.trycomp.ai/v1/organization', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/organization"

payload = {
    "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,
    "fleetDmLabelId": 123,
    "isFleetSetupCompleted": False,
    "primaryColor": "#3B82F6",
    "advancedModeEnabled": False,
    "backgroundCheckStepEnabled": True,
    "evidenceApprovalEnabled": False,
    "deviceAgentStepEnabled": True,
    "securityTrainingStepEnabled": True,
    "whistleblowerReportEnabled": True,
    "accessRequestFormEnabled": True
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "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"
}

{
  "message": "Invalid slug format"
}

{
  "message": "Invalid or expired API key"
}

{
  "message": "Organization with ID org_abc123def456 not found"
}

PATCH

organization

Update organization

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,
  "fleetDmLabelId": 123,
  "isFleetSetupCompleted": false,
  "primaryColor": "#3B82F6",
  "advancedModeEnabled": false,
  "backgroundCheckStepEnabled": true,
  "evidenceApprovalEnabled": false,
  "deviceAgentStepEnabled": true,
  "securityTrainingStepEnabled": true,
  "whistleblowerReportEnabled": true,
  "accessRequestFormEnabled": true
}
'

const options = {
  method: 'PATCH',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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,
    fleetDmLabelId: 123,
    isFleetSetupCompleted: false,
    primaryColor: '#3B82F6',
    advancedModeEnabled: false,
    backgroundCheckStepEnabled: true,
    evidenceApprovalEnabled: false,
    deviceAgentStepEnabled: true,
    securityTrainingStepEnabled: true,
    whistleblowerReportEnabled: true,
    accessRequestFormEnabled: true
  })
};

fetch('https://api.trycomp.ai/v1/organization', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/organization"

payload = {
    "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,
    "fleetDmLabelId": 123,
    "isFleetSetupCompleted": False,
    "primaryColor": "#3B82F6",
    "advancedModeEnabled": False,
    "backgroundCheckStepEnabled": True,
    "evidenceApprovalEnabled": False,
    "deviceAgentStepEnabled": True,
    "securityTrainingStepEnabled": True,
    "whistleblowerReportEnabled": True,
    "accessRequestFormEnabled": True
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "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"
}

{
  "message": "Invalid slug format"
}

{
  "message": "Invalid or expired API key"
}

{
  "message": "Organization with ID org_abc123def456 not found"
}

Authorizations

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

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

evidenceApprovalEnabled

boolean

Whether evidence requires approval before it is accepted.

Example:

false

deviceAgentStepEnabled

boolean

Whether the device-agent step is enabled during member onboarding.

Example:

true

securityTrainingStepEnabled

boolean

Whether the security-training step is enabled during member onboarding.

Example:

true

whistleblowerReportEnabled

boolean

Whether the whistleblower reporting feature is enabled.

Example:

true

accessRequestFormEnabled

boolean

Whether the trust-portal access request form is enabled.

Example:

true

Response

Organization updated successfully

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

⌘I

Overview

Reference

Update organization | Comp AI API

Authorizations

Body

Response