access

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

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

প্রমাণীকরণ

একটি বিয়ারার টোকেন হিসেবে একটি এপিআই কি পাঠান। কি-টির অবশ্যই org.update অনুমতি থাকতে হবে; এটি ছাড়া কোনো কি ৪০৪ নয়, বরং ৪০৩ ত্রুটি দিয়ে প্রত্যাখ্যাত হবে।

যেখানে আপনার অর্গানাইজেশন আইডি দেওয়া হবে

এই এন্ডপয়েন্টটি 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> }'

লগ ইন করা আছে? আপনার ড্যাশবোর্ডের এপিআই কনসোল আপনার আসল অর্গানাইজেশন আইডি এবং আপনার নিজের কি পূরণ করে দেয়, এবং লাইভ এপিআই-এর বিপরীতে অনুরোধটি চালায় যাতে আপনি প্রকৃত প্রতিক্রিয়া দেখতে পান। এই এন্ডপয়েন্টটি এপিআই কনসোলে খুলুন

বিবরণ

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