tenancy

POST `/v1/orgs`

Create an organization.

تصدیق‌هویت

د بیارر ټوکن په توګه یو API کي وسپارئ. دا پای ټکی په مشخصاتو کې کوم ځانګړی اجازه لیک نه بیانوي، نو خپل کیلي ته لږترلږه هغه څه ورکړئ چې ورته اړتیا لري او د فرض کولو پر ځای ځواب وپلټئ.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "type": <OrgType>, "name": <string> }'

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

Creates a child organization under the caller's org (reseller creating a client, etc.). Send an `Idempotency-Key` so retries never create duplicates (docs/09 §2).

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`Idempotency-Key (header)`	`string`	نه	Client-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats.

د غوښتنې بدن

نوم	ډول	اړین	دا څه شی دی
`type`	`OrgType`	هو	Organization type in the tenancy tree.
`parent_org_id`	`Uuid \| null`	نه	Defaults to the caller's org when omitted.
`name`	`string`	هو	—
`default_currency`	`CurrencyCode`	نه	—

ځواب

نوم	ډول	اړین	دا څه شی دی
`id`	`Uuid`	هو	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`type`	`OrgType`	هو	Organization type in the tenancy tree.
`parent_org_id`	`Uuid \| null`	نه	Parent in the tenancy tree; null for a top-level org.
`name`	`string`	هو	—
`brand_id`	`object`	نه	White-label brand applied to this org's surfaces.
`default_currency`	`CurrencyCode`	هو	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`status`	`string<active, suspended, closed>`	هو	—
`created_at`	`string`	هو	—

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 409 · 422 · 429

POST /v1/orgs