AckdbSegmentFolder

A folder in ONE user's segment rail (#470). Folders are a personal filing layer: they are created, read, and written only by their owner, they are flat (a folder never contains another folder), and they span grains — one folder can hold company, contact and person segments, which is what keeps a derived segment filed next to the base it was pivoted from.

Properties

idstringrequired

namestringrequired

ownerEmailstringrequired

The owner's lowercased email. Always the caller — folders are personal.

positionintegerrequired

Manual rail order within the owner's set, ascending.

segmentCountinteger

Segments in this folder the caller can currently SEE, narrowed to the requested `entityKind` (all grains when none is given). Not a raw row count: a segment that was unshared from the caller keeps its placement but is not counted, since the rail cannot render it. Present on the list response only.

createdAtstring <date-time>required

updatedAtstring <date-time>required

Example

AckdbSegmentFolder example

{
  "id": "01JA0B1C2D3E4F5G6H7J8K9M0N",
  "name": "Q3 Enterprise Push",
  "ownerEmail": "rep@acme.com",
  "position": 0,
  "segmentCount": 4,
  "createdAt": "1970-01-01T00:00:00.000Z",
  "updatedAt": "1970-01-01T00:00:00.000Z"
}