access

PUT `/v1/orgs/{orgId}/auth-policy`

Set an org's authentication policy (require MFA).

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу org.update; кључ без ње се одбија уз 403, а не 404.

Где се уноси ID ваше организације

Ова крајња тачка узима ID ваше организације у самом URL-у, као orgId. Замените га у путањи — не постоји заглавље или параметар упита који могу послужити уместо тога.

Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X PUT https://api.zinndigital.com/v1/orgs/{orgId}/auth-policy \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "require_mfa": <boolean> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Require (or stop requiring) a second factor for this org's members (docs/35 #4). When required, a member on a password-only session gets none of the org's permissions until they re-authenticate with MFA. Requires org.update; enabling additionally requires the caller's own session to be MFA (403 otherwise) so an admin cannot lock themselves out.

Параметри

Назив	Тип	Обавезно	Шта је ово
`orgId (path)`	`Uuid`	Да	Organization ID (UUIDv7).

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`require_mfa`	`boolean`	Да	When true, members must authenticate with a second factor (TOTP or a passkey) to exercise this org's access.

Одговор

Назив	Тип	Обавезно	Шта је ово
`require_mfa`	`boolean`	Да	When true, members must authenticate with a second factor (TOTP or a passkey) to exercise this org's access.

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 429

PUT /v1/orgs/{orgId}/auth-policy