FileSource

Where a file lives inside the platform. kind selects the kind of edge (room, prospect, projectNote, networkNote, self), and refId deep-links to the owning entity when applicable. label, projectId and projectName describe the owning project and are returned only to the project's owner — a counterparty (e.g. an investor on a shared prospect/room file) receives kind + refId only, never the owning project's name/id.

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).