Skip to content

Content

Briefs and drafts for the pieces an audit’s content roadmap recommends. Beta: these shapes may change; see the changelog.

GET /audits/{auditId}/content/briefs

The audit’s newest 50 briefs, newest first, without their bodies — read one brief for its payload.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
successbooleanyes
dataContentBriefSummary[]yes
{
"success": true,
"data": [
{
"id": "clrecorderbrief0000000001",
"auditId": "clrecorderaudit0000000001",
"contentPieceIndex": 0,
"sourcePiece": {
"title": "Widget software buyer's guide",
"format": "guide"
},
"version": 1,
"status": "READY",
"createdAt": "2026-10-26T19:53:04.865Z",
"updatedAt": "2026-10-26T19:53:04.865Z"
}
]
}

POST /audits/{auditId}/content/briefs

Starts generating a brief for one piece of the audit’s content roadmap (contentPieceIndex counts from 0) and answers 202; poll the brief until it is READY or FAILED. Counts against the plan’s monthly content allowance; at the cap it answers 429 with error.details.reason and nextResetAt. This starts paid work.

Terminal window
curl -X POST "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs" \
-H "Authorization: Bearer $BEKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contentPieceIndex":0}'
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
contentPieceIndexintegeryes
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.briefIdstringyes
data.versionintegeryes
data.statusstringyes

GET /audits/{auditId}/content/briefs/{briefId}

One brief with its generated payload and your editedPayload.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs/BRIEF_ID" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
briefIdpathyesstringThe brief’s id.
FieldTypeRequiredDescription
successbooleanyes
dataContentBriefyes
{
"success": true,
"data": {
"id": "clrecorderbrief0000000001",
"auditId": "clrecorderaudit0000000001",
"contentPieceIndex": 0,
"sourcePiece": {
"title": "Widget software buyer's guide",
"format": "guide"
},
"version": 1,
"status": "READY",
"createdAt": "2026-10-26T19:53:04.865Z",
"updatedAt": "2026-10-26T19:53:04.865Z",
"payload": {
"outline": [
{
"level": 2,
"heading": "How to choose widget software",
"keyPoints": [
"Team size",
"Integrations"
]
}
],
"introAngle": "Most teams outgrow their first widget tool within a year.",
"citationPlan": "Link two third-party reviews.",
"targetQueries": [
{
"angle": "BRAND_DISCOVERY",
"queryText": "what is the best widget software",
"suggestedContentType": "guide",
"expectedAiResponseFormat": "ranked list"
}
],
"sourceStrategy": [
{
"approach": "Cite independent benchmarks.",
"sourceGapDomain": "rival.com"
}
],
"wordCountTarget": 1800,
"answerEngineFormat": "A ranked list with a one-line verdict per tool.",
"schemaRecommendations": [
"FAQPage"
],
"topicOwnershipContext": "Example Co is absent from 3 of 4 answers on this topic.",
"competitorQuotesToBeat": [
{
"quote": "Rival is the simplest widget tool.",
"competitorName": "Rival"
}
],
"suggestedInternalLinks": [
{
"url": "https://example.com/pricing",
"title": "Pricing",
"anchorRationale": "Buyers compare cost."
}
]
},
"editedPayload": null
}
}

POST /audits/{auditId}/content/briefs/{briefId}/draft

Starts writing a long-form draft from a READY brief (your edit wins) and answers 202; poll the draft until it is READY or FAILED. Counts against the plan’s monthly content allowance; at the cap it answers 429 with error.details.reason and nextResetAt. This starts paid work.

Terminal window
curl -X POST "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs/BRIEF_ID/draft" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
briefIdpathyesstringThe brief’s id.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.draftIdstringyes
data.versionintegeryes
data.statusstringyes

GET /audits/{auditId}/content/briefs/{briefId}/drafts

Every draft written from the brief, newest first. content is null here; read one draft for it.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs/BRIEF_ID/drafts" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
briefIdpathyesstringThe brief’s id.
FieldTypeRequiredDescription
successbooleanyes
dataContentDraft[]yes
{
"success": true,
"data": [
{
"id": "clrecorderdraft0000000001",
"briefId": "clrecorderbrief0000000001",
"auditId": "clrecorderaudit0000000001",
"version": 1,
"status": "FAILED",
"content": null,
"contentMeta": null,
"violations": [],
"violationsTruncated": false,
"createdAt": "2026-10-26T19:53:04.866Z",
"updatedAt": "2026-10-26T19:53:04.866Z"
}
]
}

GET /audits/{auditId}/content/drafts/{draftId}

One draft with its Markdown content, which is null until the draft is READY.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/drafts/DRAFT_ID" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
draftIdpathyesstringThe draft’s id.
FieldTypeRequiredDescription
successbooleanyes
dataContentDraftyes
{
"success": true,
"data": {
"id": "clrecorderdraft0000000001",
"briefId": "clrecorderbrief0000000001",
"auditId": "clrecorderaudit0000000001",
"version": 1,
"status": "FAILED",
"content": null,
"contentMeta": null,
"violations": [],
"violationsTruncated": false,
"createdAt": "2026-10-26T19:53:04.866Z",
"updatedAt": "2026-10-26T19:53:04.866Z"
}
}

POST /audits/{auditId}/content/drafts/{draftId}/regenerate

Rewrites a READY or FAILED draft in place from its brief and answers 202; poll the draft again. Counts against the plan’s monthly content allowance; at the cap it answers 429 with error.details.reason and nextResetAt. This starts paid work.

Terminal window
curl -X POST "https://api.beket.ai/api/v1/audits/AUDIT_ID/content/drafts/DRAFT_ID/regenerate" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
draftIdpathyesstringThe draft’s id.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.draftIdstringyes
data.statusstringyes
FieldTypeRequiredDescription
idstringyes
auditIdstringyes
contentPieceIndexinteger | nullyesThe roadmap piece it was generated from.
sourcePieceobjectyesThe roadmap piece as it stood when the brief was created.
versionintegeryes
status“PENDING” | “GENERATING” | “READY” | “FAILED”yesPENDING and GENERATING are in progress; poll until READY or FAILED.
createdAtstringyes
updatedAtstringyes
payloadContentBriefPayload | nullyesThe generated brief; null until READY.
editedPayloadContentBriefPayload | nullyesAn edit saved in the dashboard; drafts are written from it when set.
FieldTypeRequiredDescription
targetQueriesobject[]yes
targetQueries[].anglestringyes
targetQueries[].queryTextstringyes
targetQueries[].expectedAiResponseFormatstring | nullyes
targetQueries[].suggestedContentTypestring | nullyes
answerEngineFormatstringyes
schemaRecommendationsstring[]yes
sourceStrategyobject[]yes
sourceStrategy[].sourceGapDomainstring | nullyes
sourceStrategy[].approachstringyes
citationPlanstringyes
outlineobject[]yes
outline[].headingstringyes
outline[].levelnumber | numberyes
outline[].keyPointsstring[]yes
wordCountTargetnumberyes
introAnglestringyes
competitorQuotesToBeatobject[]yes
competitorQuotesToBeat[].competitorNamestringyes
competitorQuotesToBeat[].quotestringyes
topicOwnershipContextstringyes
suggestedInternalLinksobject[]yes
suggestedInternalLinks[].urlstringyes
suggestedInternalLinks[].titlestring | nullyes
suggestedInternalLinks[].anchorRationalestringyes
FieldTypeRequiredDescription
idstringyes
auditIdstringyes
contentPieceIndexinteger | nullyesThe roadmap piece it was generated from.
sourcePieceobjectyesThe roadmap piece as it stood when the brief was created.
versionintegeryes
status“PENDING” | “GENERATING” | “READY” | “FAILED”yesPENDING and GENERATING are in progress; poll until READY or FAILED.
createdAtstringyes
updatedAtstringyes
FieldTypeRequiredDescription
idstringyes
briefIdstringyes
auditIdstringyes
versionintegeryes
status“PENDING” | “GENERATING” | “READY” | “FAILED”yesPENDING and GENERATING are in progress; poll until READY or FAILED.
contentstring | nullyesThe draft as Markdown. Only the single-draft read fills it.
contentMetaobject | nullyes
contentMeta.titlestringyes
contentMeta.metaDescriptionstringyes
contentMeta.jsonLdstring[]yesSuggested JSON-LD blocks, serialized.
contentMeta.wordCountintegeryes
violationsobject[]yesGuideline breaches found in the draft, capped; see violationsTruncated.
violationsTruncatedbooleanyes
createdAtstringyes
updatedAtstringyes