/api/v2/draftsGETLists the drafts of your workspace, newest first.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Response
200
total *number
drafts *object[]
Show item properties
id *string
Draft ID
content *string
Post text body
mediaItems *object[]
Media attachments referenced by public URL
Show item properties
type *"image" | "video" | "gif" | "document"
Media kind
url *string (uri)
Publicly accessible URL of the media file
thumbnail?string (uri)
Thumbnail image URL for video items. JPEG, PNG, or GIF, max 2 MB, min 640 px wide.
platforms *object[]
Platform targets the draft will publish to
Show item properties
platform *"twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
accountId?string | null
Connected account ID; resolved from the platform at publish time when omitted
content?string | null
Per-platform text override
platformSpecificData?object | null
Per-platform options, same shape as post targets
status *"ready" | "publishing"
Whether the draft can be edited or is being submitted
createdAt *string
ISO creation time
updatedAt *string
ISO last update time
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
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