Boring Marketingdocs

Score

Re-run leverage scoring to rebuild the action queue from existing opportunities and brand insights.

POSThttps://api.boringmarketing.com/brands/{brand_id}/score

Cross-references brand findings with content opportunities and rebuilds the unified action queue. Run this after updating brand context or competitors without re-running full discovery.

Duration: 1-3 minutes.

Path parameters

brand_idstringrequired

The brand UUID.

Response (202 Accepted)

{
  "run_id": "run-uuid",
  "status": "queued"
}

After completion, the refreshed queue is available via GET /brands/{id}/queue.

Example

curl -X POST \
  -H "X-API-Key: $BM_API_KEY" \
  https://api.boringmarketing.com/brands/$BRAND_ID/score

Scoring requires existing opportunities. If no discovery has been run yet, use /discover or /analyze instead.

Errors

StatusMeaning
404Brand not found, or not owned by the caller.
409Returned when (a) another scoring run is already active for this brand, or (b) a full (/analyze) run is currently writing to all tables. Other partial runs do not block this endpoint. Response carries an X-Running-Run-Id header with the existing run's UUID. Active runs older than 15 minutes are auto-expired before the conflict check.
422brand_id is not a valid UUID.