id | string | Unique identifier for the entity (UUID). |
projectId | string | Identifier of the project this entity belongs to (UUID). |
sourceId | string | null | Optional source identifier for logical content separation within a project. |
foreignId | string | null | Optional external or static identifier (e.g., "about-page" ). May not be a UUID. |
shortId | string | Auto-generated unique short identifier used for sharing or routing. |
user | UserLean | null | Optional lightweight user object representing the creator. |
title | string | null | Optional title or heading for the entity. |
content | string | null | Optional main content or description. |
mentions | Mention[] | Array of users mentioned in the content. Each item includes user ID (UUID) and username. |
attachments | Record<string, any>[] | Flexible array of media/info objects (e.g., URLs, sizes, formats). |
keywords | string[] | Tags or keywords associated with the entity. |
upvotes | string[] | Array of user IDs (UUIDs) who upvoted the entity. |
downvotes | string[] | Array of user IDs (UUIDs) who downvoted the entity. |
repliesCount | number | Total number of comments and replies associated with the entity. |
views | number | Total view count. |
score | number | Activity-based score (“hotness”) used for ranking. |
scoreUpdatedAt | Date | Timestamp of the last score calculation. |
location | { type: "Point", coordinates: [number, number] } | null | Optional GeoJSON-style location ([longitude, latitude]). |
metadata | Record<string, any> | Flexible metadata (up to 10KB) to store additional project-specific info. |
topComment | TopComment | null | Top-rated comment for this entity, if one exists. |
createdAt | Date | Timestamp when the entity was created. |
updatedAt | Date | Timestamp of the most recent update. |
deletedAt | Date | null | Timestamp when the entity was deleted, if applicable. |