cURL
curl -X POST https://api.neuraldraft.io/v1/social-posts/88/publish \
-H "Authorization: Bearer ndsk_live_yourkey"await nd.socialPosts.publish(88);
requests.post("https://api.neuraldraft.io/v1/social-posts/88/publish",
headers={"Authorization": f"Bearer {key}"})
<?php
$client->post('social-posts/88/publish', ['headers' => ['Authorization' => 'Bearer '.$key]]);
{
"id": 88,
"platforms": [
"facebook",
"instagram"
],
"status": "scheduled",
"title": "New Saturday morning class",
"media_type": "image",
"media": [
"<string>"
],
"content_per_platform": {
"facebook": "New Saturday morning class — book now → lakesideyoga.uk",
"instagram": "Slow down. Breathe. ✨ New Saturday morning class — link in bio."
},
"scheduled_at": "2023-11-07T05:31:56Z",
"published_at": "2023-11-07T05:31:56Z",
"publish_results": {
"instagram": {
"ok": true,
"external_id": "ig_178214..."
},
"facebook": {
"ok": false,
"error": "Token expired"
}
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"type": "https://api.neuraldraft.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "API key missing or invalid.",
"code": "unauthorized",
"instance": "req_2Nh4PqRsTuVw"
}{
"type": "https://api.neuraldraft.io/errors/not_found",
"title": "Not found",
"status": 404,
"detail": "No such resource.",
"code": "not_found",
"instance": "req_2Nh4PqRsTuVw"
}{
"type": "https://api.neuraldraft.io/errors/conflict",
"title": "Conflict",
"status": 409,
"detail": "A resource with this slug already exists.",
"code": "conflict",
"instance": "req_2Nh4PqRsTuVw"
}Social
Publish a social post immediately
Publishes to all linked platforms now. Returns the post with
publish_results populated per platform. Fires
social_post.published (and social_post.failed per failed
platform). 0 credits.
POST
/
social-posts
/
{id}
/
publish
cURL
curl -X POST https://api.neuraldraft.io/v1/social-posts/88/publish \
-H "Authorization: Bearer ndsk_live_yourkey"await nd.socialPosts.publish(88);
requests.post("https://api.neuraldraft.io/v1/social-posts/88/publish",
headers={"Authorization": f"Bearer {key}"})
<?php
$client->post('social-posts/88/publish', ['headers' => ['Authorization' => 'Bearer '.$key]]);
{
"id": 88,
"platforms": [
"facebook",
"instagram"
],
"status": "scheduled",
"title": "New Saturday morning class",
"media_type": "image",
"media": [
"<string>"
],
"content_per_platform": {
"facebook": "New Saturday morning class — book now → lakesideyoga.uk",
"instagram": "Slow down. Breathe. ✨ New Saturday morning class — link in bio."
},
"scheduled_at": "2023-11-07T05:31:56Z",
"published_at": "2023-11-07T05:31:56Z",
"publish_results": {
"instagram": {
"ok": true,
"external_id": "ig_178214..."
},
"facebook": {
"ok": false,
"error": "Token expired"
}
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"type": "https://api.neuraldraft.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "API key missing or invalid.",
"code": "unauthorized",
"instance": "req_2Nh4PqRsTuVw"
}{
"type": "https://api.neuraldraft.io/errors/not_found",
"title": "Not found",
"status": 404,
"detail": "No such resource.",
"code": "not_found",
"instance": "req_2Nh4PqRsTuVw"
}{
"type": "https://api.neuraldraft.io/errors/conflict",
"title": "Conflict",
"status": 409,
"detail": "A resource with this slug already exists.",
"code": "conflict",
"instance": "req_2Nh4PqRsTuVw"
}Authorizations
Project API key. Pass as Authorization: Bearer ndsk_live_.... Manage
keys via /projects/me/api-keys. Test-mode keys use
the ndsk_test_ prefix.
Path Parameters
Example:
88
Response
Published.
Example:
88
Available options:
facebook, instagram, twitter, tiktok, linkedin, youtube Example:
["facebook", "instagram"]
Available options:
draft, scheduled, published, failed Example:
"scheduled"
Example:
"New Saturday morning class"
Available options:
image, video, carousel Platform-specific copy.
Show child attributes
Show child attributes
Example:
{
"facebook": "New Saturday morning class — book now → lakesideyoga.uk",
"instagram": "Slow down. Breathe. ✨ New Saturday morning class — link in bio."
}
Per-platform publish outcomes.
Show child attributes
Show child attributes
Example:
{
"instagram": { "ok": true, "external_id": "ig_178214..." },
"facebook": { "ok": false, "error": "Token expired" }
}