Drafts

Draft commands let you save work-in-progress posts, refine them over time, and convert them into scheduled posts when you’re ready to publish.

All commands accept the global flags --json (default), --table, --verbose, --api-key <key>, and --api-url <url>. You can also authenticate with the SOME_API_KEY and SOME_API_URL environment variables.

drafts:list

List draft posts in your workspace.

so-me drafts:list [options]

Option	Description
`--page <number>`	Page number (default: `1`)
`--limit <number>`	Items per page (default: `20`)

Examples

# First page as a table
so-me drafts:list --table

# Second page, 50 per page
so-me drafts:list --page 2 --limit 50

drafts:get

Get a single draft by ID.

so-me drafts:get <id>

Argument	Description
`<id>`	Draft ID

Example

so-me drafts:get 550e8400-e29b-41d4-a716-446655440000

drafts:create

Create a new draft post.

so-me drafts:create [options]

Option	Description
`-c, --content <text>`	Draft content
`--title <title>`	Draft title
`--platform <platform>`	Social platform: `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc.
`--post-type <type>`	Content type: `TEXT`, `IMAGE`, `VIDEO`, etc.
`--description <desc>`	Draft description
`-a, --account <id>`	Social account ID
`-m, --media <urls...>`	Media URLs (from `media:upload` or CDN)
`--metadata <json>`	Metadata as JSON

The --platform value is uppercased automatically before it is sent. Media URLs passed via -m, --media are merged into the draft’s metadata, alongside any keys supplied in --metadata.

Examples

# Simple text draft
so-me drafts:create -c "Draft idea" --post-type TEXT

# Draft targeting a specific platform
so-me drafts:create -c "LinkedIn idea" --platform LINKEDIN --post-type TEXT

# Draft with a single media URL
so-me drafts:create -c "With image" --post-type IMAGE -m https://cdn.example.com/photo.jpg

# Draft with multiple media URLs
so-me drafts:create -c "Multiple media" -m url1 url2 url3 --post-type MULTIPLE_IMAGES

# Draft with custom metadata
so-me drafts:create -c "With metadata" --metadata '{"key":"value"}'

drafts:update

Update an existing draft.

so-me drafts:update <id> [options]

Argument	Description
`<id>`	Draft ID

Option	Description
`-c, --content <text>`	Updated content
`--title <title>`	Updated title
`--platform <platform>`	Social platform: `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc.
`--post-type <type>`	Updated content type
`--description <desc>`	Updated description
`-m, --media <urls...>`	Media URLs (replaces existing)
`--metadata <json>`	Updated metadata as JSON

Example

so-me drafts:update 550e8400-... -c "Revised draft copy" --title "Launch teaser"

drafts:delete

Delete one or more drafts. You’ll be asked to confirm unless you pass -y, --yes. The CLI continues deleting the remaining IDs even if one of them fails.

so-me drafts:delete <ids...> [options]

Argument	Description
`<ids...>`	One or more draft IDs

Option	Description
`-y, --yes`	Skip confirmation prompt

Examples

# Delete a single draft (prompts for confirmation)
so-me drafts:delete draft-id-1

# Bulk delete several drafts without confirmation
so-me drafts:delete draft-id-1 draft-id-2 -y

drafts:convert

Convert a draft into a post. Any options you pass override the values stored on the draft.

so-me drafts:convert <id> [options]

Argument	Description
`<id>`	Draft ID

Option	Description
`--platform <platform>`	Social platform: `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc.
`--post-type <type>`	Content type: `TEXT`, `IMAGE`, `VIDEO`, etc.
`-c, --content <text>`	Post content (overrides draft text)
`-a, --account <id>`	Social account ID
`-s, --date <date>`	Schedule date (ISO 8601)

Examples

# Convert to a Twitter post
so-me drafts:convert <id> --platform TWITTER --post-type TEXT

# Convert and schedule for LinkedIn
so-me drafts:convert <id> --platform LINKEDIN -s 2026-04-10T14:00:00Z

# Convert to an Instagram image post
so-me drafts:convert <id> --platform INSTAGRAM --post-type IMAGE

When you pass --platform but omit --account, the CLI looks up your connected accounts for that platform. If exactly one matches it’s selected automatically; if several match you’re prompted to choose one interactively. If no account is found, the conversion proceeds without a specific account and the backend decides how to handle it.

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

drafts:list

drafts:get

drafts:create

drafts:update

drafts:delete

drafts:convert

​drafts:list

​drafts:get

​drafts:create

​drafts:update

​drafts:delete

​drafts:convert

drafts:list

drafts:get

drafts:create

drafts:update

drafts:delete

drafts:convert