Delete an upload
Delete one of your uploads. Generations made from it are unaffected.
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.
DELETE
https://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
curl -X DELETE https://api2.rundiffusion.com/api/v2/uploads/$UPLOAD_ID \
-H "Authorization: Bearer $RUNDIFFUSION_TOKEN"await fetch(
`https://api2.rundiffusion.com/api/v2/uploads/${uploadId}`,
{
method: 'DELETE',
headers: { Authorization: `Bearer ${process.env.RUNDIFFUSION_TOKEN}` },
},
);requests.delete(
f"{BASE}/uploads/{upload_id}",
headers=HEADERS,
)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.
