الانتقال إلى المحتوى الرئيسي
POST
/
workspaces
/
{workspaceId}
/
organizations
/
{organizationId}
/
children
إنشاء منظمة فرعية
curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspaceId}/organizations/{organizationId}/children \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "North America Marketing",
  "limits": {
    "users": 10
  },
  "picture": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA..."
}'
{
  "id": "org_aBcDeFg123456789",
  "name": "Engineering Department",
  "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

أدخل JWT الخاص بك بالتنسيق: Bearer {token}

Path Parameters

​
workspaceId
string
required

معرّف مساحة العمل.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
organizationId
string
required

معرّف المنظمة.

Example:

"org_aBcDeFg123456789"

Body

application/json
​
name
string
required

اسم المنظمة الفرعية. 50 حرفًا كحد أقصى.

Example:

"North America Marketing"

​
limits
object

تعيين حدود الموارد للمنظمة الفرعية.

Example:
{ "users": 10 }
​
picture
string | null

رابط URL عام بصيغة HTTPS أو URI بيانات base64 للشعار.

Example:

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

Response

تم إنشاء المنظمة الفرعية بنجاح.

​
id
string

معرّف فريد للمنظمة (يتوافق مع معرّف منظمة Auth0)، يبدأ بالبادئة org_.

Example:

"org_aBcDeFg123456789"

​
name
string

الاسم القابل للقراءة البشرية للمنظمة.

Example:

"Engineering Department"

​
workspace_id
string

معرّف مساحة العمل التي تنتمي إليها هذه المنظمة.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
external_id
string<uuid>

معرّف مستقر وفريد للمنظمة، مستقل عن معرّف Auth0 الخاص بها.

Example:

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

​
parent_org_id
string | null

معرّف المنظمة الرئيسية، إذا كانت هذه منظمة فرعية.

Example:

"org_zYxWvUt987654321"

​
path
string | null

سلسلة نصية مفصولة بـ # تمثل المسار الهرمي للأسلاف.

Example:

"org_root123#org_parent456"

​
depth
integer

عمق المنظمة في التسلسل الهرمي (0 للمستوى الأعلى).

Example:

2

​
billing_account_id
string | null

معرّف حساب الفوترة المرتبط بهذه المنظمة (في وضع assigned).

Example:

"cus_a1b2c3d4e5f6g7h8"

​
picture
string<uri> | null

رابط URL لشعار المنظمة.

Example:

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

​
usage
object
​
limits
object

خريطة لحدود الموارد المطبقة مباشرة على هذه المنظمة. المفاتيح هي أنواع قابلة للقياس (locations, users, sso). القيمة null أو عدم وجود مفتاح يعني عدم تعيين حد على هذا المستوى. القيمة 0 تعني أن المورد معطل بشكل صريح.

Example:
{ "locations": 10, "users": 50 }
​
branding
object