List Object Documentation

The List object represents a structured collection of entities within Replyke, allowing users to organize and manage related items effectively.

Properties

PropertyTypeDescription
idstringUnique identifier for the list.
projectIdstring | undefinedIdentifier linking the list to a specific project.
userIdstringIdentifier of the user who owns the list.
parentIdstring | nullIdentifier of the parent list if it’s a nested list.
namestringThe name of the list.
entityIdsstring[]Array of entity IDs contained in the list.
entitiesPartial<Entity>[]Partial entity objects representing additional entity details.
createdAtDateTimestamp when the list was created.
updatedAtDateTimestamp of the most recent update.

Example Usage

Basic List

{
  "id": "list-123456",
  "projectId": "project-xyz",
  "userId": "user-789",
  "name": "Favorite Articles",
  "entityIds": ["entity-111", "entity-222"],
  "entities": [
    { "id": "entity-111", "title": "Introduction to TypeScript" },
    { "id": "entity-222", "title": "Understanding React Hooks" }
  ],
  "createdAt": "2024-02-14T12:34:56Z",
  "updatedAt": "2024-02-15T14:20:00Z"
}

Nested List

{
  "id": "list-7891011",
  "projectId": "project-abc",
  "userId": "user-222",
  "parentId": "list-123456",
  "name": "Advanced Topics",
  "entityIds": ["entity-333"],
  "entities": [
    { "id": "entity-333", "title": "Deep Dive into GraphQL" }
  ],
  "createdAt": "2024-02-14T13:45:00Z",
  "updatedAt": "2024-02-16T09:10:30Z"
}

Integration Flexibility

The List object is designed to facilitate hierarchical organization, entity grouping, and efficient retrieval. Developers can leverage it to create collections, favorites, or curated lists of related items.