access
GET /v1/orgs/{orgId}/members
List the people in an organization.
تصدیقهویت
یو API کی د بیئرر ټوکن (bearer token) په توګه ولیکئ. کی باید د members.read اجازه ولري؛ له دې اجازې پرته کی د 404 پرځای د 403 په واسطه رد کیږي.
چیرته چې ستاسو د سازمان آی ډي ځي
دا پای ټکی ستاسو د سازمان آی ډي په خپله په URL کې د orgId په توګه اخلي. دا په لاره کې ځای پرځای کړئ — هیڅ سرلیک یا پوښتنې پیرامیټر شتون نلري چې د دې پرځای کار وکړي.
ستاسو د سازمان آی ډي ستاسو په ډشبورډ کې د API کېلي پر سکرین، خپله د کېلي څنګ ته شتون لري. دا په هره هغه غوښتنه کې چې تاسو یې کوئ، ورته آی ډي وي.
هڅه وکړئ
د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.
curl -X GET https://api.zinndigital.com/v1/orgs/{orgId}/members \
-H "Authorization: Bearer zdk_live_…"ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ
تفصیلات
The org's members with their roles, paged over users (a person holding two roles is one row, not two). Each row carries removable and, when false, not_removable_reason — the engine's own answer, so a client never re-derives the removal policy and offers a button that will be refused. Requires members.read; a caller without members.remove sees removable: false on everyone.
پارامترونه
| نوم | ډول | اړین | دا څه شی دی |
|---|---|---|---|
orgId (path) | Uuid | هو | Organization ID (UUIDv7). |
cursor (query) | string | نه | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | نه | Maximum items to return (page size). |
ځواب
| نوم | ډول | اړین | دا څه شی دی |
|---|---|---|---|
data | OrgMember[] | هو | — |
page | PageMeta | هو | — |
تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي
401 · 403 · 404 · 429