AckdbIngestResponse

Response from a successful ingest operation.

Properties

dataobjectrequired

entityIdstring | nullrequired

Owning company; null for a sole-person event.

contentIdstringrequired

ULID identifier for the stored raw payload record.

createdbooleanrequired

True if a new entity was auto-created.

identityLinksCreatedintegerrequired

Number of identity links created/updated.

traitsWrittenintegerrequired

Number of traits written to storage.

deduplicatedboolean

True if this request was a duplicate (same idempotency key already exists). No new raw payload, event, or unresolved record was created. Returns 200, not an error.

fileIdsarray of

IDs of files uploaded with this ingest request. Only present when files[] was included. Files are stored but not yet processed - run `npm run process-files` to generate embeddings.

string

contactIdstring | null

Affiliation actor; null for sole-person events.

personIdstring | null

Canonical human; non-null on successful synchronous personal writes.

eventIdstring

Persisted event ID, stable on personal retries.

personsCreatedinteger

personsMatchedinteger

contactsProcessedinteger

Example

AckdbIngestResponse example

{
  "data": {
    "entityId": null,
    "contentId": "01HXYZ123456789ABCDEFGI",
    "created": true,
    "identityLinksCreated": 1,
    "traitsWritten": 1,
    "deduplicated": false,
    "fileIds": [
      "string"
    ],
    "contactId": null,
    "personId": null,
    "eventId": "string",
    "personsCreated": 0,
    "personsMatched": 0,
    "contactsProcessed": 0
  }
}