Files

Update file

Updates a file's mutable metadata. The stored bytes are immutable — re-upload to change a file's contents.

All fields are optional and follow PATCH semantics: only the fields you send are changed. For files you can rename via filename and set a description or tags. For external-video embeds you can update the source url.

patch/files/{id}

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/files/{id}
  • Auth: API key in header Authorization

Path parameters

idstring required

File ID (e.g., "file_abc123")

Request body

titlestring nullable

Human-readable display title. Pass null to clear it.

filenamestring nullable

Rename the file (updates the stored blob filename). Files only.

descriptionstring nullable

Free-text description. Pass null to clear it.

tagsstring[] nullable

Replaces the tag list. Pass an empty array to clear all tags.

urlstring nullable

New source URL for an external-video embed (YouTube, Vimeo, or Wistia).

Response

Updated file

objectstring required
idstring required
kind'file' | 'external_video' required
upload_status'pending' | 'processing' | 'ready' | 'failed' required
source'upload' | 'url_import' | 'external_video' | 'generation' required
titlestring nullable required
descriptionstring nullable required
created_atstring date-time required
updated_atstring date-time required
urlstring nullable required
tagsstring[] nullable required
source_job_idstring nullable required
filenamestring nullable required
content_typestring nullable required
sizeinteger nullable required
providerstring nullable required
file_urlstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.