Get person briefs for a set of transitions
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.
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.
API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...
In: header
Query Parameters
^([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)$uuidComma-separated transition ids (max 60)
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/transitions/briefs?project_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&ids=string"{
"briefs": {
"property1": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "building",
"subject_contact_id": "f2e4792a-d528-45f4-893b-b8be39836be5",
"margin_note": "string",
"read_md": "string",
"approach_md": "string",
"next_steps": [
null
],
"facts": [
null
],
"confidence": 0,
"caveats": "string",
"built_at": "string",
"requested_at": "string"
},
"property2": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "building",
"subject_contact_id": "f2e4792a-d528-45f4-893b-b8be39836be5",
"margin_note": "string",
"read_md": "string",
"approach_md": "string",
"next_steps": [
null
],
"facts": [
null
],
"confidence": 0,
"caveats": "string",
"built_at": "string",
"requested_at": "string"
}
}
}{
"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
}Search the leadership transitions feed GET
Enterprise catalog-wide feed over deduped K-12 leadership transition events (`leadership_transitions`) -- one row per person moving into or out of one role at one district, tracked through its lifecycle (rumored → search → finalist → confirmed → effective → departed). Filter by role class, state, lifecycle stage, transition type, buying intent, announced-date window, and a person/district keyword. Defaults exclude historical-reference mentions and district-unresolved events. Gated by the `leadership_transitions` module entitlement; otherwise responds 403 entitlement_required.
Research the person behind a transition POST
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.