---
title: "Publish Brief"
method: POST
path: "/content/briefs/{brief_id}/publish"
tags: ["content"]
---

# Publish Brief

`POST /content/briefs/{brief_id}/publish`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/content/briefs/{brief_id}/publish`
- Auth: API key in header `X-Agent-Key`

Create a WordPress DRAFT (never live) from the brief's markdown via the
Gutenberg builder. Uses the brand's verified connection — the caller's own
or a teammate's, per the org model — and the normal WordPress write gates.

## Path parameters

- `brief_id` string, uuid, required

## Query parameters

- `email` string, nullable

## Request body

- PublishBody
  - `wp_site_id` string, uuid, nullable
  - `post_type` string
  - `dry_run` boolean
  - `acknowledge_blockers` boolean
  - `acknowledge_reason` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)