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
}

Create or retry a brief POST

Idempotently request a deep-research brief for one (project, entity) pair. A ready brief is reused and a fresh in-flight build is not duplicated. Enterprise/internal organizations can request a brief without following the entity. Free organizations must follow it in the project first. Builds are asynchronous; poll the returned URL.

Search contacts GET

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