API ReferenceSub-users

Delete a sub-user

Permanently remove a sub-user and stop its traffic immediately.

DELhttps://api.riftip.com/v1/sub-users/{id}

Deletes the sub-user. Requests using its credentials are rejected straight away; its usage history stays in your account reports.

#Path parameters

Parameter	Type	Description
`id`	string, required	The sub-user's ID.

#Request

curl -X DELETE https://api.riftip.com/v1/sub-users/su_8f2k1d \
  -H "Authorization: Bearer $RIFTIP_API_KEY"

await fetch("https://api.riftip.com/v1/sub-users/su_8f2k1d", {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.RIFTIP_API_KEY}` },
});

requests.delete(
    "https://api.riftip.com/v1/sub-users/su_8f2k1d",
    headers={"Authorization": f"Bearer {API_KEY}"},
)

#Response

JSON

{ "id": "su_8f2k1d", "deleted": true }

Tip

To pause access without losing the sub-user, set status to disabled with Update a sub-user instead.