Posts

• List posts: GET /v1/posts
• Retrieve a post: GET /v1/posts/{post_id}
• Create a post: POST /v1/posts
• Update a post: PATCH /v1/posts/{post_id}
• Unschedule a post: POST /v1/posts/{post_id}/unschedule
• Publish a post now: POST /v1/posts/{post_id}/publish
• Duplicate a post: POST /v1/posts/{post_id}/duplicate
• Delete a post: DELETE /v1/posts/{post_id}

List posts

GET /v1/posts

Lists posts, newest first, with each network target's status.

Permission: posts:read

Query parameters

Response

curl https://api.nowscale.com/v1/posts \
  -H "Authorization: Bearer $NOWSCALE_API_KEY"

Retrieve a post

GET /v1/posts/{post_id}

Returns one post with each network target's status.

Permission: posts:read

Path parameters

Response

curl https://api.nowscale.com/v1/posts/POST_ID \
  -H "Authorization: Bearer $NOWSCALE_API_KEY"

Create a post

POST /v1/posts

Creates a draft or a scheduled post in a Project. Scheduling needs the posts:publish permission and follows the Project's approval policy: without it, or when the policy asks, the post waits for review. Send an Idempotency-Key so a retry never creates a second post.

Permission: posts:write · Accepts Idempotency-Key · Answers 201

Body

Response

curl -X POST https://api.nowscale.com/v1/posts \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ ... }'

Update a post

PATCH /v1/posts/{post_id}

Changes a post's text, media, targets, schedule or network settings. Fields you leave out keep their value; targets and media_ids replace the whole list.

Permission: posts:write

Path parameters

Body

Response

curl -X PATCH https://api.nowscale.com/v1/posts/POST_ID \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Unschedule a post

POST /v1/posts/{post_id}/unschedule

Moves a scheduled post back to drafts. Targets already published stay published.

Permission: posts:write

Path parameters

Response

curl -X POST https://api.nowscale.com/v1/posts/POST_ID/unschedule \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Publish a post now

POST /v1/posts/{post_id}/publish

Starts publishing every pending target now. The post's status reports the outcome as each network answers.

Permission: posts:publish · Accepts Idempotency-Key · Answers 202

Path parameters

Response

curl -X POST https://api.nowscale.com/v1/posts/POST_ID/publish \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ ... }'

Duplicate a post

POST /v1/posts/{post_id}/duplicate

Copies a post, its media and targets into a new draft in the same Project.

Permission: posts:write · Counts 5 requests · Accepts Idempotency-Key · Answers 201

Path parameters

Response

curl -X POST https://api.nowscale.com/v1/posts/POST_ID/duplicate \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ ... }'

Delete a post

DELETE /v1/posts/{post_id}

Deletes a post. Copies NOWScale already placed on networks are removed where the network allows it; the post shows status deleting until that finishes.

Permission: posts:delete · Answers 202

Path parameters

Response

curl -X DELETE https://api.nowscale.com/v1/posts/POST_ID \
  -H "Authorization: Bearer $NOWSCALE_API_KEY"