Delete user (deprecated path)

Permanently removes a user from the organization. This cascades to delete the user’s governance settings (budget/rate limits), team memberships, access profiles, and OIDC sessions. Cannot delete yourself.

DELETE /api/users/{user_id}

Error

A valid request URL is required to generate request examples

200

{
  "message": "<string>",
  "redivision_job_ids": [
    "<string>"
  ]
}

This path is deprecated and will be removed in the following major release. Use /api/governance/users/{user_id} instead.

This endpoint is available in Bifrost Enterprise only.

Authorizations

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

Path Parameters

user_id · string · required

User ID

Response

200

application/json

User deleted successfully

Simple message response

message · string

redivision_job_ids · string[]

One queued job per equal-split governance project the user belonged to, since removing them enlarges every remaining member's slice of every cap. Present only when such projects were affected. Progress is reported on the redivision_progress WebSocket channel under each id.