world:update-contact

Update an actor's contact/profile attributes — identity, contact details, professional, personal, CRM metrics

Effect: ask; Awaits an outcome — the call returns the response below.
Caller: manage_actors; The class of authority the caller must already hold, decided from the attested context with no round trip.
Reversible: yes; The effect can be undone by a later call.

Send it with your agent

One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.

Claude Code

Codex

Cursor

Gemini CLI

Claude Desktop

ChatGPT

curl -X POST https://one.ie/api/ask/world:update-contact \
  -H "Authorization: Bearer $ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": { "aid": <string> }}'

The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.

Request

Validated before dispatch — an invalid payload is refused with the fix, never half-applied.

aid string required
name string optional
firstName string optional
lastName string optional
nickname string optional
title string optional
avatar string optional
bio string optional
email string optional
phone string optional
website string optional
jobTitle string optional
company string optional
department string optional
role string optional
birthday string optional
gender string optional
nationality string optional
timezone string optional
street string optional
city string optional
region string optional
postcode string optional
country string optional
lifecycle string optional
source string optional
value number optional
fitScore number optional
nps number optional
csat number optional

Response

What comes back from the call.

ok boolean

Traffic

Every call to world:update-contact, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.

Counting…

Wiring

Every place in the open source that names world:update-contact, and the file that answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no import edge to follow and a grep is the honest shape of the question. Structure, not volume — the count is in Traffic above.

Called from

UI 3

one.ie/web/src/components/crm/ContactEdit.tsx:75
one.ie/web/src/components/in/detail/ActorContent.tsx:539
one.ie/web/src/components/settings/UserProfile.tsx:105

Docs 1

one.ie/web/src/pages/api/CLAUDE.md:61

→

Answered by

world:update-contact one.ie/web/src/lib/world-receivers.ts:2278 Dispatched through POST /api/ask/world:update-contact, after the envelope validates the payload.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "aid": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "firstName": {
      "type": "string"
    },
    "lastName": {
      "type": "string"
    },
    "nickname": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "avatar": {
      "type": "string"
    },
    "bio": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "jobTitle": {
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "department": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "birthday": {
      "type": "string"
    },
    "gender": {
      "type": "string"
    },
    "nationality": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "street": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "postcode": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "lifecycle": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "value": {
      "type": "number"
    },
    "fitScore": {
      "type": "number"
    },
    "nps": {
      "type": "number"
    },
    "csat": {
      "type": "number"
    }
  },
  "required": [
    "aid"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    }
  },
  "required": [
    "ok"
  ]
}