Briefs

Create brief

Create a content brief from a completed research session. The brief is generated from the full research context (keywords, SERP headings, content gaps, evidence, AI visibility, search intent) using the same pipeline as the Frase app. The brief is created immediately with status: "pending" and populated asynchronously. Poll status_url to check when the outline is ready.

post/briefs

Request

  • Base URL: https://next.frase.io/api/v1
  • URL: https://next.frase.io/api/v1/briefs
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Request body

research_session_idstring uuid required

ID of a completed research session (from POST /research). The brief topic, keywords, and outline are generated from the research data.

content_type'blog' | 'guide' | 'landing' | 'product' | 'comparison'

Content type for the brief

target_word_countinteger

Target word count for the article

Response

A brief already exists for this research session — reused, not recreated. research_updated_since_generation: true means the research changed after the brief was generated (the brief is STALE); rebuild it via POST /briefs/{id}/regenerate.

request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.