SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Start a brief for a topic from the evidence alone

Creates the brief with its evidence pack, target searches, questions and suggested internal links already filled in, and a plain outline built from the evidence. It spends no SoftSolz AI credits, which is the point: write the real outline yourself with your own model and PUT it back to /sites/{site_id}/briefs/{brief_id}.

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/briefs

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

topic_idintegerrequired

Topic from GET /sites/{site_id}/content-gaps.

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 POST \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/briefs \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"topic_id": 41
}'

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 · 201

{
"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"
}
}
}