Bellwork
Start free
BriefsBriefidPromote

Promote a brief's person into a contact record

"Work this person". Stores a REFERENCE to the brief entry, never its prose: the approach renders from the brief and only where that brief is in scope, so one client's positioning cannot leak into another's view. A person with no corpus contact becomes an unlinked record you can merge later.

POST
/briefs/{briefId}/promote

"Work this person". Stores a REFERENCE to the brief entry, never its prose: the approach renders from the brief and only where that brief is in scope, so one client's positioning cannot leak into another's view. A person with no corpus contact becomes an unlinked record you can merge later.

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Path Parameters

briefId*string
Formatuuid

Request Body

application/json

person_index*integer

Index into the brief's people[]

Range0 <= value
contact_id?string

Overrides the entry's own contact_id when present

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/briefs/497f6eca-6276-4993-bfeb-53cbbbba6f08/promote" \  -H "Content-Type: application/json" \  -d '{    "person_index": 0  }'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "created": true
  }
}
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "created": true,
    "unlinked": true
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Get the brief for a followed entity GET

The brief dossier for a (project, entity) pair — the read, the people who matter, what to do next, each claim sourced and dated. Built by the brief agent when a district is followed. Returns `brief: null` when the pair has never had a build; a build stuck in `building` for over 60 minutes is reported as `failed`.

Search contacts GET

Search contacts. `data` contains full contact records; contacts surface once their parent district/school has been through the extraction pipeline.