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 | string Pattern: ^-?(?:0|[1-9]\d*)$Format: int64

File size in bytes
source
Type: object · FileSource nullable

Where the file lives inside the platform (project room, prospect, project note, network-connection note, or the caller's own upload). Omitted when no edge could be resolved for the file.
- kind
  Type: string
  required
  
  Edge kind discriminator: room, prospect, projectNote, networkNote, or self.
- label
  Type: null | string
  
  Pre-resolved short label for the edge (e.g. room title). Returned only to the project's owner; omitted for counterparties, and when the label is heavy to resolve (e.g. prospect investor names).
- projectId
  Type: null | string
  
  The owning project's id, when the edge belongs to a project AND the caller owns that project. Omitted otherwise (including for counterparties on a shared file).
- projectName
  Type: null | string
  
  The owning project's name, when the edge belongs to a project AND the caller owns that project. Omitted otherwise (including for counterparties on a shared file).
- refId
  Type: null | string
  
  Deep-link target for the edge — room id for room, prospect id for prospect, network connection id for networkNote. Null for projectNote/self (no per-edge navigation target).
uploadedBy
Type: object · ActionUser 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).
- id
  Type: string
  
  User's unique identifier
- name
  Type: string
  
  User's display name
uploadedUtc
Type: stringFormat: date-time

UTC timestamp when file was uploaded