Langsung ke konten utama
POST
/
workspaces
/
{workspaceId}
/
organizations
/
{organizationId}
/
children
Buat organisasi anak
curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspaceId}/organizations/{organizationId}/children \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Pemasaran Amerika Utara",
  "limits": {
    "users": 10
  },
  "picture": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA..."
}'
{
  "id": "org_aBcDeFg123456789",
  "name": "Departemen Teknik",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "external_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "parent_org_id": "org_zYxWvUt987654321",
  "path": "org_root123#org_parent456",
  "depth": 2,
  "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
  "picture": "https://cdn.altostrat.io/logos/engineering.png",
  "usage": {
    "usage": {
      "locations": 2,
      "users": 5
    },
    "subtree_usage": {
      "locations": 10,
      "users": 25
    }
  },
  "limits": {
    "locations": 10,
    "users": 50
  },
  "branding": {
    "display_name": "ACME Corp",
    "login_hint": "acme-corp",
    "colors": {
      "primary": "#FF5733",
      "page_background": "#FFFFFF"
    }
  }
}

Authorizations

โ€‹
Authorization
string
header
required

Masukkan JWT Anda dalam format: Bearer {token}

Path Parameters

โ€‹
workspaceId
string
required

ID dari workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

โ€‹
organizationId
string
required

ID dari organisasi.

Example:

"org_aBcDeFg123456789"

Body

application/json
โ€‹
name
string
required

Nama dari organisasi anak. Maksimal 50 karakter.

Example:

"Pemasaran Amerika Utara"

โ€‹
limits
object

Atur batasan sumber daya untuk organisasi anak.

Example:
{ "users": 10 }
โ€‹
picture
string | null

URL HTTPS publik atau URI data base64 untuk logo.

Example:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA..."

Response

Organisasi anak berhasil dibuat.

โ€‹
id
string

Pengidentifikasi unik untuk organisasi (sesuai dengan ID organisasi Auth0), diawali dengan org_.

Example:

"org_aBcDeFg123456789"

โ€‹
name
string

Nama organisasi yang dapat dibaca manusia.

Example:

"Departemen Teknik"

โ€‹
workspace_id
string

ID dari workspace tempat organisasi ini berada.

Example:

"ws_a1b2c3d4e5f6g7h8"

โ€‹
external_id
string<uuid>

Pengidentifikasi unik yang stabil untuk organisasi, independen dari ID Auth0-nya.

Example:

"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"

โ€‹
parent_org_id
string | null

ID dari organisasi induk, jika ini adalah organisasi anak.

Example:

"org_zYxWvUt987654321"

โ€‹
path
string | null

String yang dipisahkan oleh # yang mewakili jalur hierarkis dari leluhur.

Example:

"org_root123#org_parent456"

โ€‹
depth
integer

Kedalaman organisasi dalam hierarki (0 untuk tingkat teratas).

Example:

2

โ€‹
billing_account_id
string | null

ID dari akun penagihan yang terkait dengan organisasi ini (dalam mode assigned).

Example:

"cus_a1b2c3d4e5f6g7h8"

โ€‹
picture
string<uri> | null

URL ke logo organisasi.

Example:

"https://cdn.altostrat.io/logos/engineering.png"

โ€‹
usage
object
โ€‹
limits
object

Peta batasan sumber daya yang diterapkan langsung ke organisasi ini. Kuncinya adalah jenis yang dapat diukur (locations, users, sso). Nilai null atau kunci yang hilang berarti tidak ada batasan yang ditetapkan pada tingkat ini. Nilai 0 berarti sumber daya secara eksplisit dinonaktifkan.

Example:
{ "locations": 10, "users": 50 }
โ€‹
branding
object