DocsAPI referenceFiles

Delete a file

Deletes an upload or an output now instead of at the end of its retention. Its links stop working at once, and a deleted upload no longer counts against the upload budget once its storage is freed.

DELETE /v1/files/{id}

Needs an API key: Authorization: Bearer $VIDEXO_API_KEY.

Parameters

Parameters
Name	In	Type	Description
`id` required	path	string, up to 128 characters	The file id.

Request

bash

curl -X DELETE "$VIDEXO_API_URL/v1/files/up_0123456789abcdef01234567" \
  -H "Authorization: Bearer $VIDEXO_API_KEY"

JavaScript

const response = await fetch(`${process.env.VIDEXO_API_URL}/v1/files/up_0123456789abcdef01234567`, {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.VIDEXO_API_KEY}` },
});
const deleted = await response.json();

Response

200 JSON

{
  "id": "up_0123456789abcdef01234567",
  "deleted": true
}

Responses

Responses
Status	Body	When
200	DeletedFile	The file was deleted.
400	Problem	invalid_request
401	Problem	authentication_failed (missing_api_key, invalid_api_key, api_key_revoked, api_key_expired)
403	Problem	permission_denied (token_scope): a client token cannot call this route
404	Problem	not_found (file)
409	Problem	conflict (upload_in_use, job_active): a queued or running job reads the upload, or the output's job has not ended
429	Problem	rate_limited