admin

User management command (Admin+step-up); typed reason, expected version, audit event

One of five commands. Every one requires an admin session with an enrolled TOTP factor, a fresh admin-sensitive step-up grant, an Idempotency-Key, a typed reason and the expected_version read from GET /api/v1/admin/users/{id}. A stale version is 409 STALE_VERSION and writes nothing. There is no balance action here and there must never be one.

set_role and set_suspension are refused with 409 CONFLICT when they would leave the system with zero admins; the check locks the admin set inside the transaction, so two demotions racing cannot both succeed.

set_suspension blocks sign-in and every API key on the next request and stops new admissions for the account, but never cancels a running rental: it keeps metering and billing to funded expiry or stop. reset_mfa clears the enrolment and every session so the user must re-enrol; it never reveals or sets a secret.

post/api/v1/admin/users/{id}/actions

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/admin/users/{id}/actions
  • Auth: HTTP bearer

Path parameters

idstring required

Headers

Idempotency-Keystring uuid required
Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Request body

OR
OR
OR

Response

Applied. Returns the new version, what changed and the stated consequence.

Changes

No recorded changes to this operation across all 1 revision of this API.