Files

Delete a file (trash or purge)

Delete a file you own (scope files:write; UUID or short id). On Basic/Pro the file goes to the trash - restorable in the web app for 7 days (Basic) or 30 days (Pro), its short id and slug still reserved - and the response reports trashed: true with trashedAt/purgeAt. Free plans hard-delete immediately (trashed: false). ?purge=1 forces an immediate hard delete on any plan, from the trash or straight past it. Deleting an already-trashed file again is a 200 no-op that repeats its trash state. An active file owned by someone else answers 403; a trashed file owned by someone else, or an unknown id, answers 404.

delete/api/v1/files/{uuid}

Request

  • Base URL: https://everypage.co
  • URL: https://everypage.co/api/v1/files/{uuid}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://everypage.co/oauth/authorize, token URL https://everypage.co/oauth/token, scopes: files:write)

Query parameters

purge'1'

Hard-delete immediately instead of trashing (Basic/Pro; Free always hard-deletes). Also purges a file that is already in the trash.

Response

Trashed, or hard-deleted (see trashed)

trashedboolean required

True when the file went to (or was already in) the trash; false after a hard delete (Free plan, or ?purge=1).

trashedAtstring date-time

When the file entered the trash. Present only when trashed is true.

purgeAtstring date-time

When the trash sweep will hard-delete it: trashedAt + 7 days (Basic) or 30 days (Pro). Present only when trashed is true.

Changes

No recorded changes to this operation across all 1 revision of this API.