access

DELETE /v1/orgs/{orgId}/members/{userId}

Remove a member and offboard them (docs/35

అన్ని access ఎండ్‌పాయింట్లు

అన్ని డెవలపర్ డాక్స్

ప్రమాణీకరణ

బీయర్ టోకెన్‌గా API కీని పంపండి. కీ తప్పనిసరిగా members.remove అనుమతిని కలిగి ఉండాలి; అది లేని కీని 404 కాకుండా 403తో తిరస్కరిస్తారు.

మీ సంస్థ ఐడీ ఎక్కడ ఉందో అక్కడ

ఈ ఎండ్‌పాయింట్ మీ సంస్థ ఐడీని నేరుగా యూఆర్‌ఎల్‌లోనే orgId రూపంలో తీసుకుంటుంది. దానిని పాత్‌లో మార్చండి — దీనికి బదులుగా పనిచేసే హెడర్ లేదా క్వరీ పారామీటర్ ఏదీ లేదు.

మీ సంస్థ ఐడి (organisation id) మీ డాష్‌బోర్డ్‌లోని API కీస్ స్క్రీన్‌పై, కీ పక్కనే ఉంటుంది. మీరు చేసే ప్రతి కాల్‌లోనూ ఇదే ఐడి ఉపయోగించబడుతుంది.

ప్రయత్నించండి

కోణీయ బ్రాకెట్‌లలో ఉన్న దేన్నైనా మీ స్వంత విలువలతో భర్తీ చేయండి, మరియు కీ ప్లేస్‌హోల్డర్‌ను మీ డాష్‌బోర్డ్ నుండి తీసుకున్న కీతో భర్తీ చేయండి.

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

సైన్ ఇన్ చేశారా? మీ డ్యాష్‌బోర్డ్‌లోని API కాన్సోల్ మీ అసలైన సంస్థ ID మరియు మీ స్వంత కీని నింపుతుంది, అలాగే మీరు అసలైన ప్రతిస్పందనను చూడటానికి లైవ్ API ద్వారా ఆభ్యర్థనను రన్ చేస్తుంది. ఈ ఎండ్‌పాయింట్‌ను API కన్సోల్‌లో తెరిచండి

వివరాలు

Removes the user from the org and runs the offboarding cascade: revokes their org access (immediate — a principal is resolved fresh per request), their Keycloak sessions (best-effort), and their own API keys, and emits member.removed so the hosting side rotates their per-site credentials. Audit-logged with the remover. Requires members.remove. Refuses (403) to remove a member more privileged than the caller, and (409) to remove the org's last owner.

పారామీటర్లు

పేరురకంకావలసినదిఇది ఏమిటి
orgId (path)UuidఅవునుOrganization ID (UUIDv7).
userId (path)UuidఅవునుThe user to remove from the organization.

ఈ ఎండ్‌పాయింట్ తిరిగి ఇవ్వగల లోపాలు

401 · 403 · 404 · 409 · 429