io.github.ndesv21/socialclaw

List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, youtube, reddit, wordpress).

Get publish capabilities and provider rules for connected accounts: what media is allowed, text limits, and whether publishing is currently possible. Pass accountId for one account, or provider to filter, or neither for all.

Start connecting a new social account. For OAuth providers this returns an authorizeUrl the user must open in a browser. Telegram requires botToken and chatId; Discord requires webhookUrl.

Upload media (image or video) to SocialClaw hosted storage. Provide either sourceUrl (a public URL the server downloads) or contentBase64. Returns an asset id and a public URL usable as media_link in schedules.

Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.

Preview how a campaign schedule document expands into concrete posts and steps without creating anything.

Create a publishing run from a schedule document. Posts are scheduled or published through connected accounts. Send an idempotencyKey so retries do not create duplicate runs.

Publish a previously created draft run, optionally at a given ISO-8601 start time.

List posts in the workspace with optional filters.

Get one post including its delivery state and provider identifiers.

List publish attempts for a post, including provider errors. Use this to debug failed posts.

Retry a failed post.

Cancel a scheduled post before it publishes.

Get the status summary of a publishing run and its posts.

Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.

Get workspace health, including connection state across providers. Pass provider to check one provider's connections.