antworkDOCS

Eliminar medios

Quita un archivo de la biblioteca. Un archivo que usa una publicación se queda.

DELETEhttps://antwork.io/api/v1/media/{id}Permisomedia

Petición

curl -X DELETE https://antwork.io/api/v1/media/med_... \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Elimina el registro de la biblioteca; el archivo guardado se conserva, como en la web. Requiere el permiso media.

Respuesta

200 OK
{ "object": "media_deleted", "id": "med_...", "deleted": true }
409 Conflict
{
  "error": {
    "type": "invalid_request_error",
    "code": "media_in_use",
    "message": "launch.mp4 is attached to 1 post(s). Remove it from them first, then delete it."
  },
  "usedInPosts": [
    { "id": "pQ7x...", "status": "scheduled", "scheduledFor": "2026-11-01T09:00:00.000Z" }
  ]
}

Un archivo que sigue adjunto a una publicación responde 409 con media_in_use y enumera las publicaciones en usedInPosts. Quítalo de ellas primero, para que un script de limpieza no rompa una publicación programada.

Un archivo que no existe o está en un espacio que no es tuyo responde 404 con media_not_found.