access

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

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

બધા access એન્ડપૉઇન્ટ્સ

પ્રમાણીકરણ

એપીઆઈ કી (API key) ને બેરર ટોકન તરીકે મોકલો. કી પાસે org.update પરવાનગી હોવી આવશ્યક છે; તેના વગરની કીને 404 ને બદલે 403 સાથે અસ્વીકાર કરવામાં આવશે.

જ્યાં તમારી સંસ્થા આઈડી જાય છે

આ એન્ડપૉઇન્ટ 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 કન્સોલ તમારી વાસ્તવિક સંસ્થાની આઈડી અને તમારી પોતાની કી ભરે છે, અને લાઇવ 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_mfabooleanહાWhen true, members must authenticate with a second factor (TOTP or a passkey) to exercise this org's access.

જવાબ

નામપ્રકારજરૂરીતે શું છે
require_mfabooleanહાWhen true, members must authenticate with a second factor (TOTP or a passkey) to exercise this org's access.

આ એન્ડપોઇન્ટ જે ભૂલો પરત કરી શકે છે

401 · 403 · 404 · 422 · 429