FLfloqer
ackDB

Update person-grain facts (avatarUrl)

The person-level setter for facts about the HUMAN. Today that is avatarUrl — the photo URL projected onto every contact read (#372). null clears it; a string replaces it (latest non-null wins, like name). http(s) URLs only — ackDB stores the link, never the bytes. A merged (tombstoned) id resolves to its survivor first. No event is emitted — presentation metadata, the entity-logo precedent.

patch/api/v1/ackdb/persons/{personId}

Request

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

Path parameters

personIdstring required

Person id (ULID = persons.person_id). A merged (tombstoned) id resolves to its survivor.

Request body

avatarUrlstring nullable

Photo URL (http(s) only, ≤2048 chars). null clears it.

primaryContactIdstring nullable

The person's PRIMARY affiliation (#544). A contact id makes that edge primary (primarySource: manual, sticky while the edge is active; must be this person's ACTIVE edge at an active company → 400, unknown → 404). null clears the override and lets the rule re-pick. Emits contact.primary_changed when the pointer moves.

Example request

{
  "avatarUrl": "https://media.licdn.com/dms/image/v2/abc/profile.jpg",
  "primaryContactId": "01J8ZD3W0L4X5Y6Z7A8B9C0D1E"
}

Response

{ data: Person }.

dataunknown required

Changes

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