FLfloqer
ackDB

Get aggregated entity profile

Returns a complete entity profile - the entity, its identity links, all traits, and recent events in a single response. This is the primary endpoint for AI agents (L1 query tier). Designed for fast, single-call retrieval of everything known about an entity.

get/api/v1/ackdb/entities/{entityId}/profile

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Path parameters

entityIdstring required

Entity ID (ULID)

Response

Aggregated entity profile

Example response

{
  "data": {
    "entity": {
      "entityId": "01HXYZ123456789ABCDEFGH",
      "name": "Acme Corp"
    },
    "identityLinks": [
      {
        "entityId": "01HXYZ123456789ABCDEFGH",
        "source": "slack",
        "externalIdType": "slack_channel_id",
        "externalIdValue": "C04ABC",
        "confidence": 1
      }
    ],
    "traits": [
      {
        "entityId": "01HXYZ123456789ABCDEFGH",
        "traitKey": "slack_message_count",
        "valueNumber": 42,
        "source": "slack",
        "workflow": "slack-ingestion",
        "confidence": 1
      }
    ],
    "recentEvents": [
      {
        "id": "01HXYZ123456789ABCDEFGH",
        "source": "slack",
        "eventType": "message",
        "summary": "Customer asked about pricing in #acme-corp"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.