Delete a User

curl --request DELETE \
  --url https://api-sandbox.finogates.com/v1/platform/users/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

Delete a User

Delete a user from your platform.

This is a soft delete — we mark the user as deleted, but their full record stays in our system for your history and audit trail. Nothing is permanently erased. After this call the user no longer appears in your user list and can’t be used for anything new.

The user’s email becomes free to use again straight away, so you can add a new user with the same email later if you need to. That new user will be a separate record with its own ID and its own wallet — the old user’s history stays linked to the old ID.

You can safely call this more than once. Deleting a user who is already deleted simply succeeds and changes nothing.

DELETE

platform

users

{user_id}

Delete a User

curl --request DELETE \
  --url https://api-sandbox.finogates.com/v1/platform/users/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

user_id

string<uuid>

required

The unique ID of the user you want to delete.

Example:

"b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4"

Response

Successful Response

Standard response wrapper for single-object responses and errors.

Generic over the payload type. A route that declares CommonResponse[SomeModel] gets the real data schema rendered in OpenAPI/Swagger; a bare CommonResponse leaves data untyped.

status_code

integer

required

HTTP status code for the response.

data

any

required

Payload or error details.

query_generated_time

integer

required

UTC timestamp (milliseconds since epoch) when response was generated.

Activate or Deactivate a User Create Payee