Approvals

Approval commands drive the post review workflow: list posts that are waiting for a decision, then approve or reject them. Rejections require a reason so the author knows what to fix.

All commands accept the global flags: --json (default) / --table, --verbose, --api-key <key>, and --api-url <url>. You can also set SOME_API_KEY and SOME_API_URL in your environment.

approvals:list

List posts pending approval in your workspace.

so-me approvals:list [options]

Option	Description	Default
`--page <number>`	Page number	`1`
`--limit <number>`	Items per page	`20`

Examples

# Default JSON output
so-me approvals:list

# Table view
so-me approvals:list --table

# Paginate
so-me approvals:list --page 2 --limit 50

approvals:approve

Approve a post that is pending approval. The approval comment is optional.

so-me approvals:approve <post-id> [options]

string

required

Post ID to approve.

Option	Description
`--comment <text>`	Optional approval comment

Examples

# Approve without a comment
so-me approvals:approve 550e8400-e29b-41d4-a716-446655440000

# Approve with feedback
so-me approvals:approve 550e8400-... --comment "Looks good, ship it!"

approvals:reject

Reject a post that is pending approval. A rejection reason is required.

so-me approvals:reject <post-id> --comment <text>

string

required

Post ID to reject.

Option	Description
`--comment <text>`	Rejection reason (required)

--comment is mandatory for approvals:reject. The command exits with an error if it is omitted.

Examples

# Reject with a reason
so-me approvals:reject 550e8400-... --comment "Needs updated branding"

# Reject every pending post in one pipeline
# (approvals:list returns a paginated { data, meta } object)
so-me approvals:list --limit 100 \
  | jq -r '.data[].id' \
  | xargs -I {} so-me approvals:reject {} --comment "Batch rejected for revision"

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

approvals:list

approvals:approve

approvals:reject

​approvals:list

​approvals:approve

​approvals:reject

approvals:list

approvals:approve

approvals:reject