AckdbTraitDefinition

Trait definition. Like Salesforce custom fields - defines what computed fields exist. AI agents discover fields by listing these at runtime.

Properties

traitKeystringrequired

Unique within org. Convention: prefix with source name.

valueTypeAckdbTraitValueTyperequired

sourcestringrequired

Which source system this trait comes from.

descriptionstring | nullrequired

Human/AI-readable description. AI agents use this to understand the trait.

allowedValuesarray | nullrequired

Optional enum constraint. Write API rejects values not in this list.

scopestring

Trait grain: entity (company) or contact. Defaults to "entity".

"entity""contact"

createdAtstring <date-time>required

Example

AckdbTraitDefinition example

{
  "traitKey": "stripe_plan",
  "valueType": "number",
  "source": "stripe",
  "description": "Monthly recurring revenue in cents from Stripe",
  "allowedValues": null,
  "scope": "entity",
  "createdAt": "1970-01-01T00:00:00.000Z"
}