Content

Get a content brief

The brief for an opportunity as Markdown: why it matters, the buyer questions to answer, what's wrong with the page today, and what only you can supply. Free — it spends no credit.

GEThttps://api.vidrys.com/v1/projects/{project_id}/content-assets/{asset_id}/brief

Plan: Grow and above
Key: read
Rate cost: 1 unit
MCP tool: get_content_brief

Get a content brief

curl --request GET \
  --url "https://api.vidrys.com/v1/projects/{project_id}/content-assets/{asset_id}/brief" \
  --header "Authorization: Bearer $VIDRYS_API_KEY"

200 · success

{
  "asset_id": "d4e5f6a7-8b9c-40d1-92e3-4f5a6b7c8d9e",
  "title": "Comparison page — Acme Invoicing vs Northwind Billing",
  "deliverable": "Comparison / buying guide",
  "needs_from_you": [],
  "markdown": "# Comparison page — Acme Invoicing vs Northwind Billing\n\n## Why this matters\n\nThree tracked questions lose to Northwind Billing on ChatGPT, Gemini and Perplexity…"
}

Authorization

Sent as a header on every request.

Authorizationstringrequired

A Vidrys API key, sent as Bearer vidrys_sk_…. A read key is enough. See Authentication.

Path parameters

project_idstringrequired

The project's id, from List projects.

asset_idstringrequired

The opportunity's id, from List content opportunities.

Response · 200

application/json

asset_idstring

The opportunity briefed.

titlestring

What to make.

deliverablestringnullable

The format, e.g. Pricing page or pitch email.

needs_from_youstring[]

Facts only you have — figures, customer names, dates.

markdownstring

The whole brief as Markdown: why it matters, the questions to answer, what to make.

Errors

404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.