Revoke superuser role from a user

DELETE

/api/v1/system-roles/superuser/{userId}

const url = 'http://localhost:3000/api/v1/system-roles/superuser/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url http://localhost:3000/api/v1/system-roles/superuser/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

Authorizations

bearer

Parameters

Path Parameters

userId

required

string format: uuid

User UUID

Header Parameters

x-organization-id

string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Responses

204

Superuser role revoked

400

Cannot revoke own superuser role or last superuser

403

Only superusers can revoke roles

404

User not found or does not have superuser role