tenancy

POST `/v1/orgs`

Create an organization.

Kimlik Doğrulama

Bir API anahtarını bearer token olarak gönderin. Bu uç nokta, teknik özelliklerde belirli bir yetki belirtmemektedir; bu nedenle, varsaymak yerine anahtarınıza ihtiyaç duyduğu en az yetkiyi verin ve yanıtı kontrol edin.

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

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

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

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).

Parametreler

Ad	Tür	Zorunlu	Ne olduğu
`Idempotency-Key (header)`	`string`	Hayır	Client-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats.

İstek gövdesi

Ad	Tür	Zorunlu	Ne olduğu
`type`	`OrgType`	Evet	Organization type in the tenancy tree.
`parent_org_id`	`Uuid \| null`	Hayır	Defaults to the caller's org when omitted.
`name`	`string`	Evet	—
`default_currency`	`CurrencyCode`	Hayır	—

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`id`	`Uuid`	Evet	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`type`	`OrgType`	Evet	Organization type in the tenancy tree.
`parent_org_id`	`Uuid \| null`	Hayır	Parent in the tenancy tree; null for a top-level org.
`name`	`string`	Evet	—
`brand_id`	`object`	Hayır	White-label brand applied to this org's surfaces.
`default_currency`	`CurrencyCode`	Evet	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`status`	`string<active, suspended, closed>`	Evet	—
`created_at`	`string`	Evet	—

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 409 · 422 · 429

POST /v1/orgs