Grant or revoke admin

PUT

/admin/users/{id}/role

Emails the account, and writes an audit row. Refuses to remove the last
admin — an account nobody can administer is not a state worth being one
request away from.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Changed, or already that role

Bodyapplication/json

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.prod-orm.io/admin/users//role' \
--header 'Content-Type: application/json' \
--data '{
    "role": "admin"
}'

Response Example

{
    "user": {
        "id": 0,
        "email": "user@example.com",
        "username": "string",
        "fname": "string",
        "lname": "string",
        "fullname": "string",
        "age": 0,
        "role": "admin",
        "birthday": "2019-08-24",
        "guardian": {
            "email": "user@example.com",
            "username": "string",
            "relationship": "parent",
            "approved": true
        },
        "emancipatedAt": "2019-08-24T14:15:22.123Z",
        "restrictions": {
            "provisioning": true,
            "signin": true
        },
        "verified": true
    },
    "changed": true
}

Modified at 2026-10-05 14:01:12

One account, with everything hanging off it

Verify an account by hand