Remove one Member from a Group

Takes one person out of one group. {id} is the GROUP (a slug such as midaz-viewer-group) and {userId} is the PERSON — the order of the two matters, and swapping them removes a membership nobody asked to remove.

The batch form, POST /v1/groups/{id}/users/remove, does the same thing for a list of people.

The account is not deleted: it loses only what this group granted. Removing somebody who is not a member is not an error. On success the response has no body (204).

Failures:

• 404 — no such group in your organization.
• 503 IDE-0066 — the identity provider is unavailable (unreachable, too slow to answer, or failing). Nothing about the request was wrong; retry it later.

DELETE /v1/groups/{id}/users/{userId}

Remove one Member from a Group

cURL

curl --request DELETE \
  --url https://identity.sandbox.lerian.net/v1/groups/{id}/users/{userId} \
  --header 'Authorization: Bearer <token>'

400

{
  "code": "<string>",
  "entityType": "<string>",
  "err": "<unknown>",
  "message": "<string>",
  "title": "<string>"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

id · string · required

Group ID.

Example:

"midaz-viewer-group"

userId · string · required

User ID.

Example:

"00000000-0000-0000-0000-000000000000"

Response

204

No Content