Skip to content

Delete an upload

Delete one of your uploads. Generations made from it are unaffected.

On this page

Deletes one upload. It stops appearing in List uploads and answers 404 on Get an upload immediately.

Only your own: uploads belong to the user who made them, and no team permission widens that, exactly as in the app.

DELETEhttps://api2.rundiffusion.com/api/v2/uploads/{upload_id}
AcceptsOAuth device flowPersonal API Access TokenCompany API Access Token

Request

Headers

AuthorizationstringRequired
Bearer token. This endpoint accepts an OAuth device flow token, a Personal API Access Token, or a Company API Access Token. See Authentication.Authorization: Bearer eyJhbGciOi…

Path parameters

upload_idstringRequired
The upload id, as returned by the list or the create response.Yb3kQ9…
curl -X DELETE https://api2.rundiffusion.com/api/v2/uploads/$UPLOAD_ID \
  -H "Authorization: Bearer $RUNDIFFUSION_TOKEN"

Response

204 No Content.

Generations already made from the upload are untouched: a run holds the bytes it was given, not a reference to the upload record. Deleting also takes the file out of upload dedupe, so re-uploading the same bytes later creates a fresh record with a new id rather than resurrecting the deleted one.

Errors

Status codes

401TOKEN_INVALID
Missing or invalid credential.
404UPLOAD_NOT_FOUND
No such upload, not yours, or already deleted. All three read the same on purpose.
429RATE_LIMITED
Too many requests. Deletes have a tighter budget than reads. See Rate limits.

View as Markdown