Grant superuser role to a user

POST

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

const url = 'http://localhost:3000/api/v1/system-roles/superuser/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'POST', 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 POST \
  --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

201

application/json

object

required

System role record ID

string

userId

required

User ID who has this role

string

userEmail

required

User email

string

userName

User name

string

role

required

Role type

string

Allowed values: SUPERUSER SUPPORT

grantedAt

required

When the role was granted

string format: date-time

grantedById

User ID who granted the role (null if granter was deleted)

string

grantedByEmail

Email of user who granted the role (null if granter was deleted)

string

reason

Reason for granting

string

revokedAt

When the role was revoked (null if active)

string format: date-time

revokedById

User ID who revoked the role

string

revokedByEmail

Email of user who revoked the role

string

isActive

required

Whether the role is currently active

boolean

Example

{
  "role": "SUPERUSER"
}

403

Only superusers can grant roles

404

User not found

409

User already has superuser role