SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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.

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

Recent Requests

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

Path Params

site_idstringrequired
brief_idstringrequired

Headers

Authorizationstringrequired

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

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

titlestring

Suggested page title.

summarystring

One paragraph on what the page has to achieve.

url_suggestionstring

Where the page should live.

outlinearray of objects

The sections, in order.

statusstring

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