Surge home page
SupportDashboard
Surge

Delete user

DELETE
/users/{id}

Deletes a user.

Once a user has been deleted, they will no longer be permitted to access any of the embedded components. Attempting to access a deleted user will return a 404 Not Found error.

Authorization

authorization
AuthorizationBearer <token>

In: header

Path Parameters

id*string

The ID of the user to delete.

Response Body

application/json

application/json

import Surge from '@surgeapi/node';

const client = new Surge({
  apiKey: process.env['SURGE_API_KEY'], // This is the default and can be omitted
});

const user = await client.users.delete('usr_01j9dwavghe1ttppewekjjkfrx');

console.log(user.id);
{
  "first_name": "Brian",
  "id": "usr_01j9dwavghe1ttppewekjjkfrx",
  "last_name": "O'Conner",
  "metadata": {
    "email": "boconner@toretti.family",
    "user_id": "1234"
  },
  "photo_url": "https://toretti.family/people/brian.jpg"
}
{
  "error": {
    "message": "The requested resource could not be found.",
    "type": "not_found"
  }
}