FortWatchFortWatchDocs
Menu

Delete an asset

DELETEhttps://api.fortwatch.ai/app/assets/{id}
Scope assets:writeOperation ID deleteAsset

Deletes the asset with its scans, findings, issues and schedules. This cannot be undone.

Parameters

NameInTypeDescription
idrequiredpathinteger

Example request

curl -X DELETE "https://api.fortwatch.ai/app/assets/42" \
  -H "Authorization: Bearer $FORTWATCH_API_KEY"

Response 200

The request succeeded.

FieldTypeDescription
messagerequiredstring
json
{
  "message": "string"
}

Errors

400The request is not valid: a field is missing or has the wrong shape (the message names it).
401No valid credentials: the API key or access token is missing, revoked or expired (INVALID_API_KEY, INVALID_TOKEN).
403Not allowed: the key or token lacks this scope (SCOPE_REQUIRED), the route is dashboard-only (SESSION_REQUIRED), or a plan limit applies.
404Not found in your workspace.
429Too many requests (RATE_LIMITED): wait the seconds Retry-After gives.