Update file metadata
PUT /files/{fileId}
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Unique identifier of the file to retrieve
Unique identifier of the file to retrieve
Request Body
Section titled “Request Body ”object
New file name or relative path (1-1000 characters). Slashes preserved. Security: no path traversal (..), absolute paths (/), or hidden files (.)
Custom key-value metadata to replace existing metadata
object
Responses
Section titled “ Responses ”File updated successfully
object
Unique identifier for the file
ID of the team that owns this file
File name or relative path (e.g., ‘file.txt’ or ‘docs/file.txt’). Slashes preserved for directory structure.
Size of the file in bytes
MIME type of the file (e.g., text/csv, application/json)
SHA-256 hash of the file contents for deduplication
User ID of who uploaded this file, or null for system uploads
Source URL if file was ingested from a URL, or null for direct uploads
Custom key-value metadata attached to the file
object
Latest processing status for the file, or null if never processed
object
Type of the latest processing event (JOB_CREATED, JOB_STARTED, JOB_FAILED, JOB_SUCCEEDED)
When this processing event occurred
Version of the processor that handled this file
Additional event-specific data
When the file was uploaded
When the file was last modified
Bad Request - Validation error or invalid input
object
Unauthorized - Authentication required or invalid token
object
Forbidden - Insufficient permissions
object
Not Found - Resource does not exist