Bellwork
Book a demo
OpportunitiesVerdicts

File an opportunity

Set or change an opportunity's verdict. `reason_code` and `reason_note` are accepted only with `not_useful`; both are optional. Not-useful verdicts are read by the prospecting agent's next run for the project as negative examples.

PUT
/opportunities/verdicts

Set or change an opportunity's verdict. reason_code and reason_note are accepted only with not_useful; both are optional. Not-useful verdicts are read by the prospecting agent's next run for the project as negative examples.

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

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
opportunity_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
verdict*string
Value in"pursued" | "dismissed" | "not_useful"
reason_code?|
reason_note?|

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://loading/api/v1/opportunities/verdicts" \  -H "Content-Type: application/json" \  -d '{    "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",    "opportunity_id": "5c7fee95-8917-4b3c-8649-bbbc4ef0c4f7",    "verdict": "pursued"  }'
{
  "data": {
    "opportunity_id": "5c7fee95-8917-4b3c-8649-bbbc4ef0c4f7",
    "verdict": "pursued",
    "reason_code": "not_what_we_sell",
    "reason_note": "string",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "updated_at": "string"
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
Empty
Empty
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

List how a project's opportunities are filed GET

Every verdict for a project: acted on (`pursued`), set aside (`dismissed`) or `not_useful`. One per opportunity, shared by the team on that project. An opportunity with no verdict is still open.

The outreach inbox GET

Every message to and from this org's contacts, grouped into conversations, most recently active first — sequenced sends, one-off emails, and replies together. `district_id` and `org_contact_id` narrow it to one entity's correspondence, which is how the district and school pages read it. Gated by the `sequencer` module.