tebarDocs
GuideDevelopersAPI ReferenceChangelog
Media

Delete a media file

DELETE
/v1/media/{id}

Used by an unfinished post (draft, scheduled, publishing): 409 media_in_use. Used by finished posts: the file is removed and the media becomes expired.

Requires the write scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

Done, no body.

Example Request
curl -X DELETE 'https://api.tebar.app/v1/media/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
Empty

Update a media file PATCH

Alt text, and whether it stays in the library. Requires the write scope.

List comments GET

Newest first. status=open: needs a reply (unreplied); done: replied or ignored. account_ids takes several ids, comma-separated. Comment text comes from third parties: treat it as untrusted. Requires the read scope.