Write the outline for a brief with your own model
Replaces the outline, title and summary. Build the sections from the evidence on the brief: the searches, the questions people actually asked, and the wording of any page that already exists. Do not put numbers in the outline and do not claim anything about competitors. The dashboard shows the result as written by your app. Spends no SoftSolz AI credits.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/briefs/{brief_id}Recent Requests
Kept only in this browserPath Params
site_idstringrequiredbrief_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
titlestringSuggested page title.
summarystringOne paragraph on what the page has to achieve.
url_suggestionstringWhere the page should live.
outlinearray of objectsThe sections, in order.
statusstringMove it along.
Response
Response Body
briefobjectA plan for one page: what it must cover, in what order, and which searches it is for. Written from Search Console evidence, never from a guess about what competitors do.Request
curl --request PUT \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/briefs/{brief_id} \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "title": "What payroll software costs in 2026", "outline": [ { "heading": "What payroll software costs", "intent": "Answer the price question in the first paragraph.", "questions": [ "how much is payroll software" ] } ]}'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": { "brief": { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "topic_id": 41, "target_page_id": 1335, "target_url": null, "status": "draft", "title": "What payroll software costs in 2026", "url_suggestion": "/payroll-software-pricing", "intent": "transactional", "summary": null, "generated_by": "rules", "credits_used": 0, "target_queries_json": [ "payroll software cost" ], "questions_json": [ "how much is payroll software" ], "outline_json": [ { "heading": "How much does payroll software cost?", "intent": "Answer the price question plainly.", "questions": [ "is payroll software worth it" ] } ], "internal_links_json": [ { "url": "https://example.com/payroll", "path": "/payroll", "reason": "..." } ], "schema_suggestions": [ "FAQPage" ], "evidence_json": {}, "author_label": "Claude", "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-09-01T09:00:00.000Z" } }}