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

External ID types this source can produce. MUST still include `domain`.

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.

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
}