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.
curl " https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id.
"id" : " clrecorderbrief0000000001 " ,
"auditId" : " clrecorderaudit0000000001 " ,
"title" : " Widget software buyer's guide " ,
"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.
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} '
Name In Required Type Description auditIdpath yes string The audit’s id.
Field Type Required Description contentPieceIndexinteger yes
Field Type Required Description successboolean yes dataobject yes data.briefIdstring yes data.versioninteger yes data.statusstring yes
GET /audits/{auditId}/content/briefs/{briefId}
One brief with its generated payload and your editedPayload.
curl " https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs/BRIEF_ID " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. briefIdpath yes string The brief’s id.
Field Type Required Description successboolean yes dataContentBrief yes
"id" : " clrecorderbrief0000000001 " ,
"auditId" : " clrecorderaudit0000000001 " ,
"title" : " Widget software buyer's guide " ,
"createdAt" : " 2026-10-26T19:53:04.865Z " ,
"updatedAt" : " 2026-10-26T19:53:04.865Z " ,
"heading" : " How to choose widget software " ,
"introAngle" : " Most teams outgrow their first widget tool within a year. " ,
"citationPlan" : " Link two third-party reviews. " ,
"angle" : " BRAND_DISCOVERY " ,
"queryText" : " what is the best widget software " ,
"suggestedContentType" : " guide " ,
"expectedAiResponseFormat" : " ranked list "
"approach" : " Cite independent benchmarks. " ,
"sourceGapDomain" : " rival.com "
"answerEngineFormat" : " A ranked list with a one-line verdict per tool. " ,
"schemaRecommendations" : [
"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 " ,
"anchorRationale" : " Buyers compare cost. "
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.
curl -X POST " https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs/BRIEF_ID/draft " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. briefIdpath yes string The brief’s id.
Field Type Required Description successboolean yes dataobject yes data.draftIdstring yes data.versioninteger yes data.statusstring yes
GET /audits/{auditId}/content/briefs/{briefId}/drafts
Every draft written from the brief, newest first. content is null here; read one draft for it.
curl " https://api.beket.ai/api/v1/audits/AUDIT_ID/content/briefs/BRIEF_ID/drafts " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. briefIdpath yes string The brief’s id.
Field Type Required Description successboolean yes dataContentDraft []yes
"id" : " clrecorderdraft0000000001 " ,
"briefId" : " clrecorderbrief0000000001 " ,
"auditId" : " clrecorderaudit0000000001 " ,
"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.
curl " https://api.beket.ai/api/v1/audits/AUDIT_ID/content/drafts/DRAFT_ID " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. draftIdpath yes string The draft’s id.
Field Type Required Description successboolean yes dataContentDraft yes
"id" : " clrecorderdraft0000000001 " ,
"briefId" : " clrecorderbrief0000000001 " ,
"auditId" : " clrecorderaudit0000000001 " ,
"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.
curl -X POST " https://api.beket.ai/api/v1/audits/AUDIT_ID/content/drafts/DRAFT_ID/regenerate " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. draftIdpath yes string The draft’s id.
Field Type Required Description successboolean yes dataobject yes data.draftIdstring yes data.statusstring yes
Field Type Required Description idstring yes auditIdstring yes contentPieceIndexinteger | null yes The roadmap piece it was generated from. sourcePieceobject yes The roadmap piece as it stood when the brief was created. versioninteger yes status“PENDING” | “GENERATING” | “READY” | “FAILED” yes PENDING and GENERATING are in progress; poll until READY or FAILED. createdAtstring yes updatedAtstring yes payloadContentBriefPayload | nullyes The generated brief; null until READY. editedPayloadContentBriefPayload | nullyes An edit saved in the dashboard; drafts are written from it when set.
Field Type Required Description targetQueriesobject[] yes targetQueries[].anglestring yes targetQueries[].queryTextstring yes targetQueries[].expectedAiResponseFormatstring | null yes targetQueries[].suggestedContentTypestring | null yes answerEngineFormatstring yes schemaRecommendationsstring[] yes sourceStrategyobject[] yes sourceStrategy[].sourceGapDomainstring | null yes sourceStrategy[].approachstring yes citationPlanstring yes outlineobject[] yes outline[].headingstring yes outline[].levelnumber | number yes outline[].keyPointsstring[] yes wordCountTargetnumber yes introAnglestring yes competitorQuotesToBeatobject[] yes competitorQuotesToBeat[].competitorNamestring yes competitorQuotesToBeat[].quotestring yes topicOwnershipContextstring yes suggestedInternalLinksobject[] yes suggestedInternalLinks[].urlstring yes suggestedInternalLinks[].titlestring | null yes suggestedInternalLinks[].anchorRationalestring yes
Field Type Required Description idstring yes auditIdstring yes contentPieceIndexinteger | null yes The roadmap piece it was generated from. sourcePieceobject yes The roadmap piece as it stood when the brief was created. versioninteger yes status“PENDING” | “GENERATING” | “READY” | “FAILED” yes PENDING and GENERATING are in progress; poll until READY or FAILED. createdAtstring yes updatedAtstring yes
Field Type Required Description idstring yes briefIdstring yes auditIdstring yes versioninteger yes status“PENDING” | “GENERATING” | “READY” | “FAILED” yes PENDING and GENERATING are in progress; poll until READY or FAILED. contentstring | null yes The draft as Markdown. Only the single-draft read fills it. contentMetaobject | null yes contentMeta.titlestring yes contentMeta.metaDescriptionstring yes contentMeta.jsonLdstring[] yes Suggested JSON-LD blocks, serialized. contentMeta.wordCountinteger yes violationsobject[] yes Guideline breaches found in the draft, capped; see violationsTruncated. violationsTruncatedboolean yes createdAtstring yes updatedAtstring yes