Snapvisor Docs
API ReferenceMedia

Delete a media

Delete a media and the files behind it. Any share link or pull request embed pointing at it stops working immediately. Use it when the user asks to remove an uploaded image or video permanently.

DELETE
/media/{mediaId}

Delete a media and the files behind it. Any share link or pull request embed pointing at it stops working immediately. Use it when the user asks to remove an uploaded image or video permanently.

Authorization

AuthorizationBearer <token>

Authenticate as a project with a project token.

Send it as a bearer token in the Authorization header:

Authorization: Bearer <project-token>

You can find your project token in your Snapvisor project settings. Project tokens are used by CI and the SDK to create builds and deployments.

In: header

Path Parameters

mediaId*string

The media ID

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/media/string"
Empty

Update a staged media PATCH

Change a staged media's name, description or branch. Staged media only. A media's name and branch are its identity — what decides whether the next upload of that name is a new version or a new media, and which pull request will publish it — and once it is published that identity is what the pull request comment is built from and what a reviewer's comments hang off. Editing it there would rewrite history rather than correct a staged media. Omitted fields are left alone. `description` and `branch` accept `null` to clear them; `name` is required and has no cleared state. Clearing a staged media's branch leaves it attached to nothing, so no pull request will ever publish it. Use it to correct a staged media's name, description or branch before a pull request publishes it.

List a media's versions GET

List a media's most recent uploaded versions, newest first, up to 100. A separate call because it is rarely needed: a media usually has one version, and the media itself already carries the newest one flattened onto it. Check `versionCount` first — at 1 there is nothing here you do not already have. Use it when a comment carries a `mediaVersionId` older than the media's current version. A pin describes a spot on *those* bytes, so feedback written on an earlier upload has to be read against that upload — match the id here to get its file.