AckdbSegmentSummary

Lightweight Segment list-item (no filter/sort/columns).

Properties

idstringrequired

namestringrequired

descriptionstring | null

entityKindstringrequired

"company""contact""person"

isDefaultbooleanrequired

True when this Segment is the default view for its entity_kind.

baseSegmentIdstring | nullrequired

Base segment id when this is a derived segment (see Segment.baseSegmentId); else null.

ownerEmailstring | nullrequired

The segment's owner (JWT email), or null for a legacy/service-created row (#284).

accessstringrequired

The caller's effective role on this row (#284) — drives client action gating.

"owner""edit""view"

folderIdstring | nullrequired

The folder THIS CALLER has filed this segment in, or null for 'Unfiled' (#470). Folders are personal: the same segment is filed differently (or not at all) for every other user, and a service/static-key call always reads null.

folderPositioninteger | nullrequired

Manual order within `folderId`, ascending. Null when unfiled.

createdAtstring <date-time>required

updatedAtstring <date-time>required

Example

AckdbSegmentSummary example

{
  "id": "01J9Z8Q3K2X7M4N5P6R7S8T9V0",
  "name": "Active paying companies",
  "description": "Companies with a paid Stripe invoice",
  "entityKind": "company",
  "isDefault": false,
  "baseSegmentId": null,
  "ownerEmail": "rep@acme.com",
  "access": "owner",
  "folderId": "01JA0B1C2D3E4F5G6H7J8K9M0N",
  "folderPosition": 0,
  "createdAt": "1970-01-01T00:00:00.000Z",
  "updatedAt": "1970-01-01T00:00:00.000Z"
}