Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.
/api/v2/drafts/{draftId}/publishPOST
Submits a draft as a real post — publish immediately with publishNow: true or schedule with scheduledFor. Targets without an accountId resolve to the platform's connected account. On success the draft is deleted and the created post is returned. Same billing rules as creating a post.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Path Parameters
draftId *string
Draft ID
Request Bodyapplication/jsonrequired
publishNow?boolean
Publish immediately. Required when scheduledFor is omitted.
scheduledFor?string
ISO 8601 datetime to schedule the post for future publishing
timezone?string
IANA timezone for the scheduled time
Response
200
success *boolean
False only when every platform failed
status *"draft" | "pending" | "scheduled" | "publishing" | "published" | "failed" | "partial"
scheduledFor?string | null
ISO 8601 datetime the post is scheduled for (scheduled posts only)
postId *string
ID of the saved post
platforms *object[]
Show item properties
platform *"twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
success *boolean
For publish-now timeout fallback, true means accepted and final status still pending
platformPostUrl?string | null
Direct URL to the published post
error?string | null
Error message when success is false
warningMessage?string | null
Warning when the post published but a non-critical follow-up failed
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
402
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
subscribeUrl?string
URL to start a subscription
403
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
limit?number
The plan limit that was hit
used?number
Current usage in this billing period
connected?number
Currently connected accounts
404 · Resource not found
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
429 · Upstream rate limit reached
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
503 · Upstream service temporarily unavailable or submission outcome unknown
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
Request example
curl -X POST "https://akarso.co/api/v2/drafts/<draftId>/publish" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "publishNow": true,
  "scheduledFor": "string",
  "timezone": "string"
}'
Powered byHolocron