File

File metadata returned after upload

contentType
Type: string
required

MIME content type (e.g., "application/pdf", "image/png")
fileName
Type: string
required

Original filename as uploaded
id
Type: string
required

Unique file identifier (use this when attaching to notes)
url
Type: string
required

Download URL for this file
contentLength
Type: integer | stringFormat: int64

File size in bytes
source
Type: nullable

Where the file lives inside the platform (Case Room, prospect, project note, network-connection note, or the caller's own upload). Omitted when no edge could be resolved for the file.

Properties: 5
uploadedBy
Type: nullable

The user who uploaded the file (id + display name). Omitted in three cases: the file has no associated end user (a system or background upload); no source edge could be resolved for the file; or the caller is not permitted to see the uploader's identity (the same visibility rules that govern who can see a participant on the deal).

Properties: 2
uploadedUtc
Type: stringFormat: date-time

UTC timestamp when file was uploaded