Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Use the TPC Site Pages API to list, create, update, and delete product pages.
/api/v1/site/pages endpoints are deprecated and will be removed in a future version. Use the unified content lifecycle API instead: GET/POST /api/v1/content, GET/PUT/DELETE /api/v1/content/{id}, plus POST /api/v1/content/generate and the review endpoints (/api/v1/content/{draftId}/review, /revision, /publish, /revert). See the API reference for schemas. Created pages land in the review queue and publish only after approval.content:read.
curl "https://app.promptingco.com/api/v1/site/pages?productId=$TPC_PRODUCT_ID&page=1&pageSize=25" \
-H "x-api-key: $TPC_API_KEY"
curl "https://app.promptingco.com/api/v1/site/pages?productId=$TPC_PRODUCT_ID&query=pricing&status=published&pathPrefix=docs/&hasContent=true" \
-H "x-api-key: $TPC_API_KEY"
content:write.
curl "https://app.promptingco.com/api/v1/site/pages" \
-X POST \
-H "content-type: application/json" \
-H "x-api-key: $TPC_API_KEY" \
-H "Idempotency-Key: page-create-docs-install" \
--data '{
"productId": "'"$TPC_PRODUCT_ID"'",
"pages": [
{
"slug": "docs/install",
"title": "Install",
"content": "# Install\n\nInstall instructions."
}
]
}'
curl "https://app.promptingco.com/api/v1/site/pages" \
-X PATCH \
-H "content-type: application/json" \
-H "x-api-key: $TPC_API_KEY" \
-H "Idempotency-Key: page-update-page-123" \
--data '{
"productId": "'"$TPC_PRODUCT_ID"'",
"pages": [
{
"id": "page_123",
"title": "Install The Prompting Company",
"status": "published"
}
]
}'
curl "https://app.promptingco.com/api/v1/site/pages" \
-X DELETE \
-H "content-type: application/json" \
-H "x-api-key: $TPC_API_KEY" \
-H "Idempotency-Key: page-delete-page-123" \
--data '{
"productId": "'"$TPC_PRODUCT_ID"'",
"pageIds": ["page_123"]
}'
import { readFile, readdir } from "node:fs/promises";
import { join, relative } from "node:path";
async function syncMarkdownFolder(root: string, productId: string, apiKey: string) {
const names = await readdir(root);
const pages = [];
for (const name of names) {
if (!name.endsWith(".md")) continue;
const path = join(root, name);
const content = await readFile(path, "utf8");
const slug = relative(root, path).replace(/\.md$/, "");
pages.push({
slug,
title: slug.replace(/-/g, " "),
content,
});
}
const results = [];
for (let index = 0; index < pages.length; index += 25) {
const batch = pages.slice(index, index + 25);
const response = await fetch("https://app.promptingco.com/api/v1/site/pages", {
method: "POST",
headers: {
"content-type": "application/json",
"x-api-key": apiKey,
"Idempotency-Key": `markdown-sync-${index}-${Date.now()}`,
},
body: JSON.stringify({ productId, pages: batch }),
});
results.push(await response.json());
}
return results;
}