Publish Post
POST
/api/v1/dashboard/content/posts/{post_id}/publishOverview
Publishes a blog post, setting its status to published and recording the published_at timestamp. Once published, the post becomes visible via the public Get Post and List Posts 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 |
|---|---|---|---|
post_id | string (UUID) | Yes | The unique identifier of the post to publish |
Request Body
No request body is required.
Response
Returns the full PostResponse 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/posts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/publish" \
-H "Authorization: Bearer $CLIENT_TOKEN"
import requests
post_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
resp = requests.post(
f"https://spideriq.ai/api/v1/dashboard/content/posts/{post_id}/publish",
headers={"Authorization": f"Bearer {CLIENT_TOKEN}"},
)
post = resp.json()
print(f"Status: {post['status']}")
print(f"Published at: {post['published_at']}")
const postId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";
const resp = await fetch(
`https://spideriq.ai/api/v1/dashboard/content/posts/${postId}/publish`,
{
method: "POST",
headers: { "Authorization": `Bearer ${CLIENT_TOKEN}` },
}
);
const post = await resp.json();
console.log(`Status: ${post.status}`);
console.log(`Published at: ${post.published_at}`);
Example Response
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "getting-started-with-spideriq",
"title": "Getting Started with SpiderIQ",
"status": "published",
"published_at": "2026-04-08T12:00:00Z",
"author": {
"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
"full_name": "Martin Shein",
"slug": "martin-shein",
"avatar_url": "https://cdn.spideriq.ai/authors/martin.webp",
"bio": "Founder of SpiderIQ."
},
"tags": ["getting-started", "tutorial"],
"categories": [],
"is_featured": true,
"updated_at": "2026-04-08T12:00:00Z"
}
Status Codes
| Status Code | Meaning | Description |
|---|---|---|
| 200 | OK | Post published successfully |
| 401 | Unauthorized | Invalid or missing Bearer token |
| 404 | Not Found | Post not found or belongs to another client |