Content documents

Use /api/v1/content for product content, including manually supplied pages, generated content, review drafts, and published documents. The legacy /api/v1/site/pages surface is deprecated. You need content:read for reads and content:write for mutations. Set TPC_API_KEY and your product ID as described in the quickstart.

Read a document

You need content:read.

curl "https://app.promptingco.com/api/v1/content/$DOCUMENT_ID" \
  -H "x-api-key: $TPC_API_KEY"

Find a document by path

Use path lookup when your source system knows the product path instead of the document ID:

curl "https://app.promptingco.com/api/v1/content/by-path?brandId=$TPC_PRODUCT_ID&path=docs/install" \
  -H "x-api-key: $TPC_API_KEY"

The query parameter is still named brandId for this legacy endpoint. Pass the product ID.

Update a document

You need content:write.

curl "https://app.promptingco.com/api/v1/content/$DOCUMENT_ID" \
  -X PUT \
  -H "content-type: application/json" \
  -H "x-api-key: $TPC_API_KEY" \
  -H "Idempotency-Key: document-update-$DOCUMENT_ID" \
  --data '{
    "title": "Install The Prompting Company",
    "content": "# Install The Prompting Company\n\nSet up TPC and publish content.",
    "metaTitle": "Install The Prompting Company",
    "metaDescription": "Set up TPC and publish content."
  }'

Update priority

Use PATCH when you only need to change document priority:

curl "https://app.promptingco.com/api/v1/content/$DOCUMENT_ID" \
  -X PATCH \
  -H "content-type: application/json" \
  -H "x-api-key: $TPC_API_KEY" \
  -H "Idempotency-Key: document-priority-$DOCUMENT_ID" \
  --data '{
    "priority": 80
  }'

Review workflows

Create review drafts with POST /api/v1/content (up to 25 pages per request) or request generated content with POST /api/v1/content/generate. For POST /api/v1/content, send one product selector: productId or productSlug. Each supplied page needs slug, title, and Markdown content; use canonicalDomainId for an optional publishing destination. List the review queue with:

curl "https://app.promptingco.com/api/v1/content?productId=$TPC_PRODUCT_ID&status=pending_review" \
  -H "x-api-key: $TPC_API_KEY"

Use the draft ID from created[].id or the review queue for draft actions:

Action	Endpoint
Approve or reject	`POST /api/v1/content/{draftId}/review` with `action: "approve"` or `action: "reject"` and optional `feedback`
Submit edits or request an AI revision	`POST /api/v1/content/{draftId}/revision`
Queue publishing of an approved draft	`POST /api/v1/content/{draftId}/publish`
Unpublish and return to review	`POST /api/v1/content/{draftId}/revert`
Cancel pending or generating content	`POST /api/v1/content/{draftId}/cancel`

Approval automatically queues publishable content for publishing. A successful approval response is not proof that publishing has finished. Unapproved drafts cannot be published; an explicit publish request returns 409. To update a live document, use its document ID with the PUT and PATCH examples above. To edit a review draft, use /revision.

Domains and archival

Domain attachment is public: use PATCH /api/v1/content/{documentId}/domains with attach, detach, and optional canonicalDomainId. Domain IDs must be UUIDs. Use DELETE /api/v1/content/{documentId} to archive a live document, and POST /api/v1/content/{documentId}/restore to restore it. Deleting an unpublished review draft by its draft ID removes the draft directly; the restore endpoint is for archived live documents. See the API reference for request schemas and the endpoints available to your integration. Metadata suggestion routes remain internal.

Get started

Concepts

Content API

API Reference

Content documents

Content documents

Read a document

Find a document by path

Update a document

Update priority

Review workflows

Domains and archival

​Content documents

​Read a document

​Find a document by path

​Update a document

​Update priority

​Review workflows

​Domains and archival

Content documents

Read a document

Find a document by path

Update a document

Update priority

Review workflows

Domains and archival