Skip to content

Delete a wordlist

DELETE/v1/wordlists/{id}Key scope write

Deletes a wordlist and all its terms. Templates that enable its policy keep the key, which then scores 0.

Needs a key with the write scope. Authentication

curl -X DELETE https://api.useinfrared.com/v1/wordlists/wl_5KcJIqikl2tXcuKJHvpzgO \
  -H "Authorization: Bearer $INFRARED_KEY"
200 OKResponse
{
  "deleted": true,
  "id": "wl_5KcJIqikl2tXcuKJHvpzgO"
}

Path parameters

idstringRequired

Id of the wordlist: wl_ plus 22 base62 characters.

Returns

An object with deleted set to true and the id of the deleted wordlist.

  • 200 OKAn object

Errors

404
not_found

The key's project has no wordlist with this id.

Every endpoint can also answer the errors any request can meet: a missing key, a rate limit, a malformed body. Errors

Something missing or unclear on this page? Write to support@useinfrared.com.