# Briefs

Parse content briefs into structured article parameters

## Parse a content brief

> Parse a content brief (any format: formal document, bullet points, or narrative) into structured article generation parameters.\
> Returns extracted outline, keywords, tone, audience, content gaps, and instructions that can be used with POST /v1/contents.<br>

```json
{"openapi":"3.1.0","info":{"title":"Cuppa API","version":"1.0.0"},"tags":[{"name":"Briefs","description":"Parse content briefs into structured article parameters"}],"servers":[{"url":"https://api.cuppa.ai"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v1/briefs":{"post":{"summary":"Parse a content brief","description":"Parse a content brief (any format: formal document, bullet points, or narrative) into structured article generation parameters.\nReturns extracted outline, keywords, tone, audience, content gaps, and instructions that can be used with POST /v1/contents.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["content"],"properties":{"content":{"type":"string","description":"The raw content brief text to parse (minimum 50 characters)"},"model":{"type":"string","description":"AI model for parsing (e.g. gpt-5-mini, claude-sonnet-4-5). Defaults to team default."}}}}}},"responses":{"200":{"description":"Brief parsed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Target article title or H1"},"target_keyword":{"type":"string","description":"Primary target keyword"},"secondary_keywords":{"type":"array","items":{"type":"string"},"description":"Secondary keywords"},"word_count":{"type":"integer","description":"Target word count"},"tone":{"type":"string","description":"Tone/style directive"},"target_audience":{"type":"string","description":"Target audience description"},"article_type":{"type":"string","enum":["general","listicle","review","howto"]},"outline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"integer","description":"Heading level (2 for H2, 3 for H3)"},"title":{"type":"string","description":"Heading text"},"instructions":{"type":"string","description":"Section-specific instructions"}}}},"content_gaps":{"type":"array","items":{"type":"string"},"description":"Required differentiation points"},"paa_questions":{"type":"array","items":{"type":"string"},"description":"People Also Ask questions"},"extra_instructions":{"type":"string","description":"Catch-all for other editorial rules and requirements"}}}}}}},"tags":["Briefs"]}}}}
```