Remove a media

Removes a media from the library of its establishment, as the app does. The file is not destroyed and a scheduled post keeps its visual.

DELETEhttps://api.sofia-post.com/api/v1/media/{id}

DELETE/v1/media/{id}

API key or access tokenKept in this tab only, and sent only to api.sofia-post.com.id (path)

This request acts on your real account.

curl -X DELETE 'https://api.sofia-post.com/api/v1/media/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Authorizations

Authorizationstringrequired
Your personal key or OAuth access token, sent as Bearer <token>.

Path parameters

idstringrequired
Identifier of the media.

Response

204

The media left the library.

401

The token is missing, unknown, expired or revoked.

402

subscription_required.

403

live_mode_required for a test application, or the media:write scope is missing.

404

media_not_found: outside the establishments of the Workspace, or already removed.

4XXapplication/json

Any other error, in the error envelope.

Remove a media

curl --request DELETE \
  --url 'https://api.sofia-post.com/api/v1/media/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "error": {
    "code": "invalid_request",
    "message": "The request is invalid",
    "docUrl": "https://www.sofia-post.com/developers/errors#invalid_request",
    "requestId": "2aab5943-6333-4caf-8478-25a85ebd4abf"
  }
}