Bellwork
Start free
OpportunitiesId

Review an opportunity (internal only)

Concierge review gate: publish a draft (makes it customer-visible) or dismiss it. **Internal/admin only** (requires the `internal` plan); other orgs receive 403. **Free (0 credits).**

PATCH
/opportunities/{id}

Concierge review gate: publish a draft (makes it customer-visible) or dismiss it. Internal/admin only (requires the internal plan); other orgs receive 403. Free (0 credits).

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
Formatuuid

Request Body

application/json

action*string
Value in"publish" | "dismiss"

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://loading/api/v1/opportunities/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "action": "publish"  }'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "status": "string",
    "published_at": "string"
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
Empty
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

List opportunities GET

Agent-produced, verified sales opportunities for the caller's projects. Customers see only published rows (enforced by RLS); internal users also see drafts for concierge review. **Free (0 credits).**

Start an on-demand prospecting run POST

"Find me more opportunities" — kicks off one agent research run for a project the caller owns. Results land in the opportunities feed as they are verified (typically 30-45 minutes). Requires completed project onboarding. **Free (0 credits).**