Skip to main content
DELETE
Delete agent file
Deleting a file is permanent and affects every agent in the account. No agent can send it afterwards, and instructions or rules that mention its @handle stop sending it. The request has no confirmation field, so confirm with a person first and name the file.
  • To stop only some tasks or one agent from sending the file, use Set availability instead. That keeps the file and can be undone.
  • The response returns the handle that stopped working. Search your instructions and rules for it and update them.

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

id
string<uuid>
required

File ID, from List files. A malformed ID returns 400 Validation error.

Response

File deleted.

success
enum<boolean>
required
Available options:
true
deleted
enum<boolean>
required
Available options:
true
file_id
string<uuid>
required
handle
string
required

The @handle that stopped working.

Last modified on September 29, 2026