Eliminar Media - dopost Docs

DELETE

/api/v1/media/{mediaId}

Elimina permanentemente un archivo multimedia y su miniatura del almacenamiento.

Solicitud

Reemplaza {mediaId} con el id del archivo multimedia a eliminar.

curl --request DELETE \
  --url https://dopost.co/api/v1/media/<mediaId> \
  --header 'x-api-key: <apiKey>'

curl --request DELETE \
  --url https://dopost.co/api/v1/media/<mediaId> \
  --header 'x-api-key: <apiKey>'

Respuesta

200 OK

{
  "message": "Media deleted",
  "mediaId": "cm3abc123def456"
}

{
  "message": "Media deleted",
  "mediaId": "cm3abc123def456"
}

Esta acción es irreversible. El archivo y su miniatura se eliminarán permanentemente del almacenamiento.

Qué se elimina

El archivo original en el almacenamiento en la nube
La miniatura generada automáticamente (si existe)
El registro de media en la base de datos

Los posts que referencian la URL del media eliminado mantendrán su contenido existente — la URL seguirá apareciendo en los datos del post, pero el archivo ya no será accesible.

Respuestas de error

Status	Error	Causa
401	`Invalid or missing API key`	Header `x-api-key` inválido o faltante
403	`API key does not have permission for this action`	La API key no tiene el scope necesario para este endpoint
404	`Media not found`	El `mediaId` no existe en tu workspace
429	`Rate limit exceeded`	Demasiadas peticiones. Revisa las cabeceras `X-RateLimit-*` y reintenta tras el tiempo indicado