Move a file to Deleted
Move a file to Deleted (restorable for 30 days), or delete it for good with permanent=true (posts:delete)
Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.
Requires posts:delete; media:write alone answers 403. A file in Deleted is still served and still counts toward storage; the retention sweep deletes it for good 30 days later (purge_at). Moving a file that a scheduled or publishing post uses answers 409. With permanent=true the file is deleted now and posts referencing it lose it.
AuthorizationBearer <token>API key (stk_...), or in the Community Edition the access token (stk_local_...)
id*stringpermanent?booleanfalseIdempotency-Key?stringReplays the stored response when the same key is repeated with the same method, path,
query string and body within 24 hours (422 idempotency_mismatch with a different
request, 409 idempotency_in_progress while the first one runs). Not applied to
multipart uploads or to responses that carry a secret.
length <= 200Moved to Deleted (or deleted for good)
curl -X DELETE 'https://staqly.example.com/v1/media/string'