Skip to main content

Authentication

One OAuth login gives the CLI access to view data, publish posts, reply to comments, and manage settings and connections. Users do not choose scopes or sign in again for another capability. Login itself does not post or change anything. A clear later request to publish, schedule, edit a scheduled post, upload media for a requested post, or send a supplied reply is enough authorization; do not ask for a second confirmation.

Health

Upload

This command:
  1. calls Mallary to create a presigned upload URL
  2. uploads the local bytes for you
  3. returns the final Mallary media URL
Use the returned URL as media[].url for media, or as media[].thumbnail_url for video thumbnails in file-mode post payloads.

Posts

After publishing, grouped post results include the per-platform post IDs and public post URLs that the provider makes available.

Comments

Comments commands are available on all plans. They list comments from Mallary-published posts and post the exact reply text you provide.

Jobs

Completed jobs include platform_post_id and platform_post_url in JSON mode, and print Post ID / Post URL in normal output when available.

Analytics

Browse all saved post analytics with filters and page through the results:
You can also use --status, --media-type, --search, and --json. The JSON result includes each post’s platform metrics, total, and next_cursor.

Audience

Get the latest follower or subscriber count for every connected account in a profile:
Mallary updates supported counts once every 24 hours. TikTok returns followers when the connection includes audience stats access. LinkedIn shows permission_required until Mallary adds the permission it needs.

Profiles

Webhooks

List:
Create:
Delete:

Settings

Platforms

platforms list includes each destination’s selectable post_types. Platforms whose format is chosen from the content and media report automatic selection.

Drafts

Requires CLI 0.2.18 or later. Saved drafts are available to all users. Draft saves use no posting allowance. They never publish or assign a date.
Use the draft UUID and current revision returned by Mallary. The numbers above are examples; read the actual revision before each write. A 409 means you must read again. Supplied lists and platform settings replace their saved values; omitted fields stay unchanged. Use --file changes.json with empty arrays to clear media, comments, or destinations. Create and edit support --message, repeated --platform, --profile-id, repeated --media, --thumbnail, repeated --comment, --post-type, --auto-reply-enabled, or --file. File mode supports the draft API content fields. --expected-revision is required for edits and can be supplied with file mode. Local media files upload to Mallary before saving. A saved draft does not make uploaded media private.

Publish or Schedule

Only use these commands when the user asks to publish or schedule the saved post:
Omit the date to publish now. Normal plan, account, content, and platform checks apply. Validation failures leave the draft saved. Repeating the exact revision and schedule returns the original publishing jobs. After an uncertain response, read the draft; a submitted draft includes submission. Do not create a new post as a retry. Draft saves reject schedule fields, webhook URLs, and publishing idempotency keys. List and get use read scope. Save, edit, delete, and submit use publish scope. For reads, deletes, and submissions, --profile-id optionally verifies the source profile. For edits, it changes the saved profile. A draft uses one connection profile.
Last modified on October 9, 2026