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}PATCH
Updates a draft. Omitted fields keep their current value.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Path Parameters
draftId *string
Draft ID
Request Bodyapplication/jsonrequired
content?string
New post text body
mediaItems?object[]
Replacement media attachments
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[]
Replacement platform targets
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
Response
200
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
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 PATCH "https://akarso.co/api/v2/drafts/<draftId>" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "string",
  "mediaItems": [
    {
      "type": "image",
      "url": "https://example.com",
      "thumbnail": "https://example.com"
    }
  ],
  "platforms": [
    {
      "platform": "twitter",
      "accountId": "string",
      "content": "string",
      "platformSpecificData": {}
    }
  ]
}'
Powered byHolocron