Rename organization

POST

/api/v1/organizations/{id}/rename

curl --request POST \
  --url http://localhost:3000/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rename \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "name": "example", "slug": "example" }'

• Development
• Production

Renames an organization with new name and optional slug. Requires Super Admin privileges.

Authorizations

• api-key
• bearer

Parameters

Path Parameters

id

required

string format: uuid

Organization UUID

Header Parameters

x-organization-id

string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Request Body^required

Media typeapplication/json

object

name

required

New name for the organization

string

slug

New slug for the organization (optional, auto-generated from name if not provided)

string

Example^generated

{
  "name": "example",
  "slug": "example"
}

Responses

200

Organization renamed successfully

Media typeapplication/json

object

id

required

Unique organization identifier

string format: uuid

name

required

Organization display name

string

slug

required

Unique URL-friendly identifier

string

description

Organization description

string

settings

required

Organization-specific settings

object

key

additional properties

any

branding

required

Organization branding configuration

object

key

additional properties

any

status

required

Organization status

string

Allowed values: active suspended pending disabled

lastActivityAt

Last activity timestamp

string format: date-time

nullable

primaryContact

Primary contact name

string

nullable

billingEmail

Billing email address

string format: email

nullable

active

required

Whether the organization is active (deprecated, use status)

boolean

createdAt

required

When the organization was created

string format: date-time

updatedAt

required

When the organization was last updated

string format: date-time

stats

Organization resource statistics

object

userCount

required

Total number of users in the organization

number

activeUsers

required

Number of active users in the organization

number

deviceCount

required

Total number of devices in the organization

number

activeDevices

required

Number of online or provisioned devices

number

deploymentCount

required

Total number of deployments in the organization

number

runningDeployments

required

Number of running deployments

number

Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Acme Corporation",
  "slug": "acme-corp",
  "description": "Leading manufacturer of industrial automation equipment",
  "settings": {
    "timezone": "America/New_York",
    "locale": "en-US"
  },
  "branding": {
    "primaryColor": "#003366",
    "logo": "https://example.com/logo.png"
  },
  "status": "active",
  "lastActivityAt": "2024-06-20T14:45:00Z",
  "primaryContact": "John Smith",
  "billingEmail": "billing@acme-corp.com",
  "active": true,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-06-20T14:45:00Z",
  "stats": {
    "userCount": 25,
    "activeUsers": 20,
    "deviceCount": 150,
    "activeDevices": 120,
    "deploymentCount": 42,
    "runningDeployments": 35
  }
}

400

Invalid input data

401

Unauthorized

403

Forbidden - Super Admin required

404

Organization not found

409

Slug already exists