XISUITEDokumentation

Organizations

9 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

Create organization (onboarding)#

POST/organizationsToken

Creates a new organization, adds the authenticated user as owner, and links the user to the organization.

Request-Bodyapplication/jsonCreateOrganizationDto

NameTypBeschreibung
namePflichtstring

Organization display name

Beispiel: Acme Corp

slugPflichtstring

URL-safe slug (lowercase, hyphens allowed)

Beispiel: acme-corp

sizePflichtstring

Organization size tier

Werte: smallmediumlargeenterprise

Beispiel: medium

Antworten

  • 201Organization created successfully
  • 400User already has an org or slug is taken
  • 401Not authenticated
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/organizations" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Corp","slug":"acme-corp","size":"medium"}'

Get organization by ID (admin/owner only)#

GET/organizations/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring–

Antworten

  • 200Organization returned
  • 403Insufficient role or wrong organization
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/organizations/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update organization (admin/owner only)#

PATCH/organizations/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring–

Request-Bodyapplication/jsonUpdateOrganizationDto

NameTypBeschreibung
namestring

Beispiel: Acme Corp

slugstring

Beispiel: acme-corp

sizestring

Werte: smallmediumlargeenterprise

is_activeboolean–
default_space_idobject

Default space ID, or null to clear

Antworten

  • 200Organization updated
  • 403Insufficient role or wrong organization
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/organizations/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Corp","slug":"acme-corp","size":"small"}'

Get organization branding#

GET/organizations/brandingToken

Returns the branding configuration for the user's organization. Returns null if no branding is configured.

Antworten

  • 200Branding config returned
  • 401Not authenticated
  • 403Insufficient role
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/organizations/branding" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Upsert organization branding#

POST/organizations/brandingToken

Creates or updates branding configuration (primary color, logo URLs/paths) for the organization.

Request-Bodyapplication/jsonUpsertBrandingDto

NameTypBeschreibung
organizationIdstring

Legacy compatibility field. Ignored; organization is derived from auth context.

primary_colorobject

Primary brand color hex code

Beispiel: #3B82F6

logo_light_urlobject

Public URL for the light-mode logo

logo_light_pathobject

Storage path for the light-mode logo

logo_dark_urlobject

Public URL for the dark-mode logo

logo_dark_pathobject

Storage path for the dark-mode logo

emblem_light_urlobject

Public URL for the light-mode emblem

emblem_light_pathobject

Storage path for the light-mode emblem

emblem_dark_urlobject

Public URL for the dark-mode emblem

emblem_dark_pathobject

Storage path for the dark-mode emblem

Antworten

  • 201Branding upserted successfully
  • 401Not authenticated
  • 403Insufficient role
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/organizations/branding" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organizationId":"…","primary_color":"#3B82F6","logo_light_url":{}}'
POST/organizations/branding/logoToken

Uploads a logo to a specific slot (logo_light, logo_dark, emblem_light, emblem_dark). Max 5 MB. Supported formats: JPEG, PNG, WebP, SVG.

Request-Bodymultipart/form-data

NameTypBeschreibung
slotPflichtstring

Werte: logo_lightlogo_darkemblem_lightemblem_dark

filePflichtstring (binary)–

Antworten

  • 201Logo uploaded successfully
  • 400Invalid slot, file type, or file too large
  • 401Not authenticated
  • 403Insufficient role
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/organizations/branding/logo" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -F "file=@./datei.pdf"
DELETE/organizations/branding/logoToken

Deletes a logo from the specified slot and clears the branding fields.

Parameter

NameOrtTypBeschreibung
slotPflichtQuerystring

The logo slot to delete

Werte: logo_lightlogo_darkemblem_lightemblem_dark

Antworten

  • 200Logo deleted successfully
  • 400Invalid or missing slot
  • 401Not authenticated
  • 403Insufficient role
  • 404Branding not found
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/organizations/branding/logo" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Upsert per-surface branding theme#

POST/organizations/branding/themeToken

Sets backgrounds and typography for the app shell and wiki. Requires the feature_custom_branding entitlement.

Request-Bodyapplication/jsonUpsertBrandingThemeDto

NameTypBeschreibung
theme_configobject

Per-surface branding theme (backgrounds + typography for app shell and wiki)

Antworten

  • 201Branding theme upserted
  • 401Not authenticated
  • 403Insufficient role or feature_custom_branding not entitled
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/organizations/branding/theme" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"theme_config":{}}'

Get platform-wide statistics for the current organization#

GET/organizations/statisticsToken

Antworten

  • 200Statistics returned
  • 403Insufficient role
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/organizations/statistics" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions