AckdbSourceUpdateRequest

Partial source edit. Every field is optional; provided fields replace the existing ones. Allowed on custom sources and shipped packs (an edit marks the row `user_modified`).

Properties

displayNamestring

Human-readable name.

descriptionstring

What data this source carries.

versionstring

Source version string.

queryingGuidestring | null

Agent-facing querying guidance. Pass null to clear it.

identityLinkTypesarray of

May be empty when every declared event is person_only and allowCustomEventTypes is false. Otherwise must include domain. Add domain before adding company event types or allowing custom types.

string

eventTypeFieldstring

Which content.metadata field determines the event type.

eventTypePrefixstring

Namespace prefix for event types.

defaultContentNaturestring

Default content nature applied to events that don't specify one.

"conversational""structured""activity-signal"

allowCustomEventTypesboolean

Toggle the custom-event-types escape hatch.

defaultTraitsarray of

Default traits (each key must be `<sourceType>_*`).

AckdbSourceCreateDefaultTrait

disabledboolean

Whether the source rejects new ingest (422 SOURCE_DISABLED) without deleting its schema or history. Shipped packs ship `true` on a fresh deployment (opt-in per source); set `false` here to activate one.

contextOnlyboolean (nullable)

This source's events describe a PERSON but anchor to a company (`job` → the employer, `education` → the school), so the entities it mints are context rather than accounts (#493). A company whose only ingested evidence comes from such sources is hidden from the Companies grain and excluded from every score population. NULLABLE: `null` means never-decided and lets the pack loader seed it; `true`/`false` is a decision the loader will not overwrite.

Example

AckdbSourceUpdateRequest example

{
  "displayName": "string",
  "description": "string",
  "version": "string",
  "queryingGuide": null,
  "identityLinkTypes": [
    "string"
  ],
  "eventTypeField": "string",
  "eventTypePrefix": "string",
  "defaultContentNature": "conversational",
  "allowCustomEventTypes": false,
  "defaultTraits": [
    {
      "traitKey": "app_usage_dau",
      "valueType": "number",
      "description": "string",
      "allowedValues": [
        "string"
      ]
    }
  ],
  "disabled": false,
  "contextOnly": false
}