access

GET `/v1/orgs/{orgId}/roles`

List the roles the caller may grant in an organization.

Autentifikacija

Pošaljite API ključ kao bearer token. Ključ mora imati dozvolu members.read; ključ bez nje se odbija sa 403, a ne sa 404.

Gde ide ID vaše organizacije

Ovaj krajnji tačka uzima ID vaše organizacije direktno u URL-u kao orgId. Zamenite ga u putanji — ne postoji zaglavlje ili query parametar koji to može zameniti.

ID vaše organizacije nalazi se na ekranu sa API ključevima u vašoj kontrolnoj tabli, pored samog ključa. To je isti ID u svakom pozivu koji uputite.

Isprobajte

Zamenite bilo šta u uglastim zagradama sopstvenim vrednostima, a ključni placeholder sa ključem sa vaše kontrolne table.

curl -X GET https://api.zinndigital.com/v1/orgs/{orgId}/roles \
  -H "Authorization: Bearer zdk_live_…"

Prijavljeni ste? API konzola na vašoj kontrolnoj tabli automatski popunjava ID vaše stvarne organizacije i vaš sopstveni ključ, i izvršava zahtev nad API-jem uživo tako da možete videti stvarni odgovor. Otvorite ovu krajnju tačku u API konzoli

Detalji

Filtered by the same escalation rule the invite flow enforces (a role holding a permission the caller lacks is not grantable, register #31), so every role returned is one an invitation will accept. Requires `members.read`. Unpaged — the role catalogue is a fixed, small set.

Parametri

Naziv	Vrsta	Obavezno	Šta je ovo
`orgId (path)`	`Uuid`	Da	Organization ID (UUIDv7).

Odgovor

Naziv	Vrsta	Obavezno	Šta je ovo
`data`	`AssignableRole[]`	Da	—

Greške koje ovaj krajnji tačka može da vrati

401 · 403 · 404 · 429