Bellwork
Start free
TransitionsIdResearch

Research the person behind a transition

On-demand person research: starts one person-brief agent run for (project, transition) — the same research the nightly cron pre-builds for the most relevant moves. Responds 202 with status=building when a run starts; a ready brief or a fresh in-flight build short-circuits with 200 and started=false. Same `leadership_transitions` module gate as GET /transitions; the project_id must belong to the caller's organization.

POST
/transitions/{id}/research

On-demand person research: starts one person-brief agent run for (project, transition) — the same research the nightly cron pre-builds for the most relevant moves. Responds 202 with status=building when a run starts; a ready brief or a fresh in-flight build short-circuits with 200 and started=false. Same leadership_transitions module gate as GET /transitions; the project_id must belong to the caller's organization.

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

id*string

Transition id

Formatuuid

Request Body

application/json

project_id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/transitions/497f6eca-6276-4993-bfeb-53cbbbba6f08/research" \  -H "Content-Type: application/json" \  -d '{    "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9"  }'
{
  "status": "string",
  "started": true
}
{
  "status": "building",
  "started": true
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "entitlement_required",
  "module": "string",
  "message": "string",
  "contact": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Get person briefs for a set of transitions GET

Batched read of agent-researched person briefs for the binder: every (project, transition) brief among the given transition ids, keyed by transition id. A brief carries the seller-specific margin note, the narrative read, sourced facts, and confidence. Same `leadership_transitions` module gate as GET /transitions; the project_id must belong to the caller's organization.

Get the source articles behind a transition GET

Every article linked to one transition event (`transition_sources`), newest first -- the receipts behind the deduped record. Same `leadership_transitions` module gate as GET /transitions.