Publish Page
POST
/api/v1/dashboard/content/pages/{page_id}/publishOverview
Publishes a content page, setting its status to published and recording the published_at timestamp. Once published, the page becomes visible via the public Get Page and List Pages endpoints.
Authentication
info
Bearer authentication required - Pass your credentials as Authorization: Bearer <client_id>:<api_key>:<api_secret>.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer <client_id>:<api_key>:<api_secret> |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string (UUID) | Yes | The unique identifier of the page to publish |
Request Body
No request body is required.
Response
Returns the full page object with status set to published and published_at populated.
Example Request
- cURL
- Python
- JavaScript
curl -X POST "https://spideriq.ai/api/v1/dashboard/content/pages/e5f6a7b8-c9d0-1234-efab-567890123456/publish" \
-H "Authorization: Bearer $CLIENT_TOKEN"
import requests
page_id = "e5f6a7b8-c9d0-1234-efab-567890123456"
resp = requests.post(
f"https://spideriq.ai/api/v1/dashboard/content/pages/{page_id}/publish",
headers={"Authorization": f"Bearer {CLIENT_TOKEN}"},
)
page = resp.json()
print(f"Status: {page['status']}")
print(f"Published at: {page['published_at']}")
const pageId = "e5f6a7b8-c9d0-1234-efab-567890123456";
const resp = await fetch(
`https://spideriq.ai/api/v1/dashboard/content/pages/${pageId}/publish`,
{
method: "POST",
headers: { "Authorization": `Bearer ${CLIENT_TOKEN}` },
}
);
const page = await resp.json();
console.log(`Status: ${page.status}`);
console.log(`Published at: ${page.published_at}`);
Example Response
{
"id": "e5f6a7b8-c9d0-1234-efab-567890123456",
"slug": "about",
"title": "About Us",
"status": "published",
"published_at": "2026-04-08T12:00:00Z",
"template": "default",
"blocks": [
{
"type": "hero",
"data": {
"heading": "About Our Company",
"subheading": "We help businesses find and connect with their ideal customers."
}
}
],
"updated_at": "2026-04-08T12:00:00Z",
"seo_title": "About Us | SpiderIQ",
"seo_description": "Learn about SpiderIQ and our mission.",
"og_image_url": null
}
Status Codes
| Status Code | Meaning | Description |
|---|---|---|
| 200 | OK | Page published successfully |
| 401 | Unauthorized | Invalid or missing Bearer token |
| 404 | Not Found | Page not found or belongs to another client |