Delete User

Delete the information for an user with the specified ID.

The Delete User endpoint allows you to delete an user in the Instantuploader API. Only the parent account can delete users, and the user is deleted based on the ID.

This endpoint requires authentication with a JWT token or API key. The authenticated user must be the parent agency of the account being deleted.

Body

DELETE https://api.instantuploader.com/user

This endpoint does not require a request body.

Example: /user/?userId=0258a873456fdfc2ac1abfdca6441

Query Parameters

Name	Type	Description
userId*	String	The ID of the user to delete all details of the user

200: OK

{
  "accountId": "f09394dc775a870f9c7b8f98e45a",
  "address": "",
  "agencyId": "10d125c1277ac06295d25b79edc6",
  "businessCategories": [],
  "businessLabels": [],
  "businessServices": [],
  "businessTags": [],
  "city": "",
  "contentType": {
    "id": "7eb49931fab86365a07f137db5fe",
    "name": "Project"
  },
  "coordData": {
    "geohash": ""
  },
  "coords": "44.00,44.0114",
  "createDate": "2021-05-31T11:51:57.0Z",
  "customerName": "",
  "datetimeStamp": 516,
  "description": "",
  "internalNote": "",
  "lock": {},
  "media": [],
  "neighborhood": "",
  "permitNumber": "",
  "pipelineId": "5c760838b1976bc7465b5fa8fff9",
  "presentation": {},
  "seo": {
    "permalink": "title_"
  },
  "smartTags": [],
  "stage": "1cb355e1ebaf70bb46eda2f6d3f9",
  "status": {
    "content": "draft",
    "publish": "notPublished",
    "service": "open"
  },
  "tasks": [],
  "testimonial": {},
  "title": "",
  "updateDate": "2021-05-31T11:51:57.0Z",
  "userId": "user_id",
  "writings": {}
} 

404: Not Found

Content is deleted or uid of content is incorrect

403: Forbidden

Example:

HTTP

DELETE /account/{accountId} HTTP/1.1
Host: api.instantuploader.com
Authorization: Bearer <your_token_or_api_key>

Node

const axios = require('axios');

const accountId = '123456';

axios.delete(`https://api.instantuploader.com/account/${accountId}`, {
  headers: {
    Authorization: 'Bearer <your_token_or_api_key>',
  },
});

PHP

<?php
$accountId = '123456';

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.instantuploader.com/account/' . $accountId,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <your_token_or_api_key>',
  ],
]);

$response = curl_exec($curl);

curl_close($curl);

If the account is successfully deleted, the endpoint will return a 404 No Content status code with an empty response body. If the authenticated user is not the parent agency of the account being deleted, the endpoint will return a 403 Forbidden status code.