UserRemovalRequests

Asks to demote or deactivate an Organization Admin (or steps the key's creator down).

Requires ManageUsers and an Idempotency-Key. The key's creator must be an active Organization Admin (a System Admin changes roles directly instead) and id an Organization Admin of the same organization with no other pending request. The target is notified (in the app and by e-mail) and can approve it (applies at once) or contest it until effectiveAt, 14 days from now; otherwise it is applied shortly after that. When id is the key's creator, it is their own approval and applies at once (200). Refused (409) when it would leave the organization with no active Organization Admin. Example: POST /api/v1/users/8f0c3c1e-2b6d-4c55-9a51-0d3f3c1b7e21/removal-requests { "action": "Demote", "newRole": "Manager" }.

post/api/v1/users/{id}/removal-requests

Request

  • Base URL: https://app.flexonthejob.com
  • URL: https://app.flexonthejob.com/api/v1/users/{id}/removal-requests
  • Auth: HTTP bearer

Path parameters

idstring required

User id (string GUID) of the Organization Admin to remove.

Request body

action'Demote' | 'Deactivate' required

What a removal request does to the Organization Admin.

newRole'Manager' | 'User'

A role an Organization Admin may be demoted to.

reasonstring nullable

Optional note shown to the admin being removed, up to 500 characters. Example: "Leaving the company on Friday".

Response

Self-removal: the change was made (applied: true).

appliedboolean

True when this call demoted / deactivated the account (approval or self-removal).

messagestring

What happened. Example: "Removal requested: pat@example.com will be demoted to Manager on 2026-10-07 (UTC) unless they contest it, or sooner if they approve."

Changes

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