Posts

The posts command group lets you list, create, update, schedule, retry, and delete posts across any connected platform. All commands accept the global flags (--json default, --table, --verbose, --api-key, --api-url) and read credentials from SOME_API_KEY / SOME_API_URL when those flags are omitted.

posts:list

List posts in your workspace with optional filtering. Use posts:calendar to filter by a date range instead.

so-me posts:list [options]

Option	Description	Default
`--status <status>`	Filter by status: `SCHEDULED`, `POSTED`, `FAILED`, `PENDING`, `PENDING_APPROVAL`, `REJECTED`, `DRAFT`	–
`--platform <platform>`	Filter by platform (e.g. `TWITTER`, `LINKEDIN`)	–
`--page <number>`	Page number	`1`
`--limit <number>`	Items per page (max `100`)	`20`

Example

so-me posts:list --status SCHEDULED --platform TWITTER --table

posts:get

Get a single post by ID with full details.

so-me posts:get <id>

Argument	Description
`<id>`	Post ID (required)

Example

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

posts:calendar

Get scheduled posts within a specific date range. Useful for calendar-style views.

so-me posts:calendar --start <iso-date> --end <iso-date>

Option	Description
`--start <date>`	Start date (ISO 8601) (required)
`--end <date>`	End date (ISO 8601) (required)

Example

so-me posts:calendar --start 2026-04-01T00:00:00Z --end 2026-04-30T23:59:59Z

posts:create

Create a new post targeting any connected platform. Omit --date to publish immediately, or provide an ISO 8601 timestamp to schedule for later.

so-me posts:create -c <text> [options]

Option	Description	Default
`-c, --content <text>`	Post content (required)	–
`-s, --date <date>`	Scheduled date (ISO 8601). Omit to publish immediately	–
`-t, --type <type>`	Post type: `schedule` or `draft`	`schedule`
`-m, --media <items>`	Comma-separated local file paths and/or media file IDs	–
`-a, --accounts <ids>`	Account ID to post from	–
`--post-type <type>`	Content type: `TEXT`, `IMAGE`, `VIDEO`, `CAROUSEL`, `REEL`, `STORY`	`TEXT`
`--platform <platform>`	Social platform: `TWITTER`, `LINKEDIN`, etc.	`TWITTER`
`--metadata <json>`	Platform-specific metadata as JSON	–
`-j, --json-file <path>`	Path to a JSON file describing a complex post	–

Examples

# Simple text post (publishes immediately)
so-me posts:create -c "Hello world!" --platform TWITTER

# Scheduled LinkedIn post
so-me posts:create -c "Scheduled post" -s 2026-04-10T14:00:00Z --platform LINKEDIN

# Post with a local image file
so-me posts:create -c "With media" -m ./photo.jpg --post-type IMAGE

# Post referencing existing media library file IDs
so-me posts:create -c "By file id" -m file-id-1,file-id-2 --post-type IMAGE

# Save as a draft instead of scheduling
so-me posts:create -c "Work in progress" -t draft --platform TWITTER

# Complex post from a JSON file
so-me posts:create -j ./campaign.json

The -m, --media option accepts a comma-separated mix of local file paths and existing media file UUIDs. Local files are presigned and uploaded automatically; UUIDs are hydrated from your media library. Each item must be either a readable file path or a valid file UUID — anything else is rejected. Supported file types include PNG, JPG, JPEG, GIF, WebP, SVG, MP4, MOV, AVI, WebM, MP3, WAV, and PDF.

If you don’t pass --accounts and have multiple accounts for the chosen platform, the CLI prompts you to select one interactively. When creating a draft (-t draft), the account is optional — the post is submitted without one if none is provided or resolved.

When -j, --json-file is supplied, the file contents are used verbatim as the request body and the other flags (-c, --platform, --media, etc.) are ignored.

posts:update

Update an existing post’s text, scheduled date, or platform-specific metadata.

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

Argument	Description
`<id>`	Post ID (required)

Option	Description
`-c, --content <text>`	Updated content
`-s, --date <date>`	Updated scheduled date (ISO 8601)
`--metadata <json>`	Updated platform-specific metadata as JSON

Example

so-me posts:update 550e8400-e29b-41d4-a716-446655440000 -c "Updated content" -s 2026-04-16T10:00:00Z

posts:delete

Delete one or more posts. Deleting a single ID hits the single-delete endpoint; passing multiple IDs uses bulk delete. Prompts for confirmation unless -y is set.

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

Argument	Description
`<ids...>`	One or more post IDs (required)

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

Examples

# Delete a single post
so-me posts:delete 550e8400-e29b-41d4-a716-446655440000

# Delete multiple posts and skip confirmation
so-me posts:delete id-1 id-2 id-3 -y

posts:bulk-delete

Delete multiple posts by ID in a single bulk request. Prompts for confirmation unless -y is set.

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

Argument	Description
`<ids...>`	Post IDs to delete (required)

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

Example

so-me posts:bulk-delete id-1 id-2 id-3 -y

posts:schedule

Schedule a post for a future date.

so-me posts:schedule <id> -s <date>

Argument	Description
`<id>`	Post ID (required)

Option	Description
`-s, --date <date>`	Schedule date (ISO 8601, must be in the future) (required)

Example

so-me posts:schedule 550e8400-e29b-41d4-a716-446655440000 -s 2026-04-15T14:00:00Z

posts:unschedule

Remove a post from the schedule.

so-me posts:unschedule <id>

Argument	Description
`<id>`	Post ID (required)

Example

so-me posts:unschedule 550e8400-e29b-41d4-a716-446655440000

posts:retry

Retry a failed post. The post is re-queued for publishing.

so-me posts:retry <id>

Argument	Description
`<id>`	Post ID (required)

Example

so-me posts:retry 550e8400-e29b-41d4-a716-446655440000

posts:resubmit

Resubmit a rejected post for approval.

so-me posts:resubmit <id>

Argument	Description
`<id>`	Post ID (required)

Example

so-me posts:resubmit 550e8400-e29b-41d4-a716-446655440000

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

posts:list

posts:get

posts:calendar

posts:create

posts:update

posts:delete

posts:bulk-delete

posts:schedule

posts:unschedule

posts:retry

posts:resubmit

​posts:list

​posts:get

​posts:calendar

​posts:create

​posts:update

​posts:delete

​posts:bulk-delete

​posts:schedule

​posts:unschedule

​posts:retry

​posts:resubmit

posts:list

posts:get

posts:calendar

posts:create

posts:update

posts:delete

posts:bulk-delete

posts:schedule

posts:unschedule

posts:retry

posts:resubmit