Plan, start, finish or dismiss an opportunity
Move it through open, in_progress, won, lost or dismissed. Every change is recorded with who made it, so the board doubles as the record of what was tried. Marking something done does not itself prove it worked; the next monthly report measures that.
PATCH
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/opportunities/{opportunity_id}Recent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredopportunity_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
statusstringrequiredWhere the work now stands.
reasonstringWhy, in a few words. Shown on the board.
Response
Response Body
opportunityobjectOne piece of work worth doing, scored and tracked across months. This is the unit the growth board is built from.Request
curl --request PATCH \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/opportunities/{opportunity_id} \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "status": "in_progress", "reason": "Rewriting the page this sprint"}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": { "opportunity": { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "kind": "fix_snippet", "kind_label": "Rewrite the title and description", "family": "content", "pillar": "seo", "action": "refresh", "is_win": false, "entity_type": "page", "question_id": null, "question": null, "subject_key": null, "task_id": null, "page_id": 1335, "query_id": 812, "topic_id": 41, "title": "Rewrite the title and description on /pricing", "score": 59.28, "score_components": { "gap": { "value": 1, "weight": 0.3 }, "demand": { "value": 0.62, "weight": 0.22 } }, "opportunity_clicks": 29, "est_value": null, "effort": "low", "confidence": 0.666, "status": "open", "first_seen_on": "2026-05-01", "last_seen_on": "2026-08-01", "occurrence_count": 4, "baseline_json": { "clicks": 4, "impressions": 900, "position": 14.2 }, "evidence_json": { "finding_count": 2 }, "recommendation_id": null, "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-09-01T09:00:00.000Z" } }}