AckdbIngestResponse

Response from a successful ingest operation.

Properties

dataobjectrequired

entityIdstringrequired

The entity this data was stored against.

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

Example

AckdbIngestResponse example

{
  "data": {
    "entityId": "01HXYZ123456789ABCDEFGH",
    "contentId": "01HXYZ123456789ABCDEFGI",
    "created": true,
    "identityLinksCreated": 1,
    "traitsWritten": 1,
    "deduplicated": false,
    "fileIds": [
      "string"
    ]
  }
}