Skip to main content
POST
Generate a brief

Authorizations

Authorization
string
header
required

Your API key, e.g. Authorization: Bearer gp_live_....

Path Parameters

id
string<uuid>
required

Brand id.

Body

application/json
content_type
enum<string>
required

The shape of article to write. smart picks the shape for you.

Available options:
blog_post,
listicle,
comparison,
guide,
how_to,
smart
prompt_ids
string<uuid>[]
required

The questions this article should win. At least one.

cited_page_urls
string[]
required

The already-cited pages to study, from /citations/urls. At least one: nothing is chosen for you.

title
string

Leave it out and one is written for you.

topic
string

Optional. Taken from your prompts when you leave it out.

instructions
string

Anything else the article should account for, such as the audience or an angle to take.

source_recommendation_id
string<uuid>

Records that this article came from a recommendation.

Response

Accepted

data
object
required

Generation has started. The work continues after this response returns.