Bolta

Showing 25 of 75 from the live probe.

• List Workspaces

  List all workspaces accessible by your API key

• Get Workspace

  One workspace's details — including its `timezone`, which is what create-routine's required `timezone` parameter wants for a scheduled routine, plus its name, plan and settings. Read-only.

• Get My Capabilities

  Check what the current API key or agent is allowed to do in a workspace. `permissions` is the caller's role intersected with the scopes this key actually carries; `denied_by` says why each denied action is denied (`role`, `workspace_plan`, or `key_scope`).

• List Social Accounts

  List all connected social accounts in workspace. Renders a card with Socials and Buckets tabs — connected accounts with their health, plus the workspace's social buckets (named account groups).

• Get Social Connect Link

  Get a URL that takes the user to Bolta's social-account connect page. Use this whenever the workspace has no connected account for the platform the user wants to publish to — OAuth cannot run inside the chat, so share this link and ask the user to complete the connection in their browser, then re-check with list-accounts.

• List Social Buckets

  List the workspace's social buckets — named groups of connected accounts used to publish to several accounts at once (e.g. 'Launch Team' = LinkedIn + X). Each bucket includes its member accounts (id, platform, username). Renders in the accounts card's Buckets tab.

• Create Social Bucket

  Create a social bucket — a named group of connected accounts for one-shot multi-account publishing. Users phrase this naturally: 'create a bucket called Launch Team with my LinkedIn and X accounts' — resolve the accounts via list-accounts and pass their ids as account_ids.

• Update Social Bucket

  Rename a social bucket and/or replace its member accounts. Users phrase this naturally: 'add my Instagram to the Launch Team bucket' — fetch the bucket's current members via list-buckets, adjust the list, and pass the full replacement as account_ids (ids from list-accounts).

• List Workspace Posts

  List posts in a workspace with optional filters, rendered as a posts card. For "how did my post(s) do" questions, call with status=published, a start_date/end_date window (e.g. today or the last 7 days), and include_metrics=true — each post then carries per-platform engagement (views, likes, comments, reposts). FRESHNESS: metrics sync nightly from the platforms; for posts published less than ~24h ago, tell the user metrics may not have synced yet — zeros on a fresh post mean 'not synced', NOT th

• List Scheduled Posts

  List all scheduled posts in a workspace

• Get Post

  Get details of a specific post

• Create Post

  Create ONE post (draft or scheduled). EXACTLY one — this tool is single-use per turn. If the request needs two or more posts — the same idea adapted for several platforms is the common case — call bulk-create-posts ONCE instead. Do not call this tool twice; do not loop it. Each call renders its own card and the user sees only the last one, so a second call does not add a post to the reply, it HIDES the first. That failure is invisible from here: both calls return 200 and the user quietly recei

• Update Post

  Update an existing post's text, media, poll, schedule, or status. Omitted fields are left unchanged. Use this to attach an image generated in this conversation to a post that already exists — pass it in media. Updates happen in place: the post keeps its id and its full activity history, so never delete and recreate a post to change it. QUALITY BLOCKED RECOVERY: this is how you repair a post whose status is 'Quality Blocked'. Send the rewritten content and the quality check re-runs on it automati

• Delete Post

  Delete a post. Recoverable for 7 days — the post is hidden immediately and permanently destroyed after the undo window.

• Get Platform Post Details

  Read the platform-specific settings attached to a post for one platform. Supports x, threads, reddit, linkedin, facebook, instagram, bluesky, mastodon, discord, tiktok, pinterest, youtube, wordpress — e.g. Reddit subreddit + flair, TikTok privacy + duet/stitch, YouTube title/privacy/tags, Pinterest board + title, Threads reply controls, WordPress title + SEO meta. The returned fields tell you exactly what update-post-platform-details accepts for that platform.

• Update Platform Post Details

  Set platform-specific settings on a post after creating it, for any of: x, threads, reddit, linkedin, facebook, instagram, bluesky, mastodon, discord, tiktok, pinterest, youtube, wordpress. Reddit: selected_subreddit_id, flair_id, flair_text. TikTok: privacy_level, disable_comments/duet/stitch. YouTube: video_title, privacy_status, tags, category_id, made_for_kids. Pinterest: board_id, title, description, link. Threads: reply_control, topic_tag. WordPress: title (the blog post's headline — alway

• Bulk Create Posts

  Create MULTIPLE posts in one call. ALWAYS use this instead of calling create-post repeatedly whenever the user asks for more than one post (e.g. 'a week of content', 'make 7 posts') — looping create-post renders a separate card per post and the user only ever sees one of them. Use create-post only for a single post. Returns a task_id; the card polls bulk-create-status itself and lists every post's copy when the work lands, so you do NOT need to poll or restate the copy. Each post goes through th

• Bulk Create Status

  Check the status of a bulk post creation task. The response's quality_blocked array is read live from the posts, so it stays accurate even for a post demoted after the task reported SUCCESS: each entry names the post, why it was blocked, and how to fix it. Repair those with update-post before submit-for-review.

• Schedule Post

  Schedule a post for future publishing. Requires admin or owner role. If workspace Safe Mode is ON and the post is a Draft, it is rerouted to Pending Approval instead of being scheduled. AFTER SCHEDULING A BATCH: finish with one list-workspace-posts call (status=scheduled) so the posts card on screen reflects the new state. Cards are snapshots of the call that drew them — the bulk-create card still shows every post as it was at creation, so without that final call the user reads 'Draft' under a m

• Publish Post

  Immediately queue a post for publishing. Requires admin or owner role. Blocked when workspace Safe Mode is ON — use submit-for-review instead.

• Create WordPress Blog Post

  Create a SERP-ready WordPress blog post in one call: resolves the WordPress account, creates the draft, sets WordPress article settings (title, excerpt, categories, tags, SEO meta), uploads featured/inline images to WordPress's real Media Library, and optionally submits for review, schedules, or publishes — all without separate list-accounts / update-post-platform-details / submit-for-review calls. Never invent the topic, images, or destination the user didn't ask for. If wordpress_account_id is

• List Recently Deleted

  Posts and agent jobs deleted in the last 7 days that can still be restored with restore-deleted. Each item carries its type (post|job), a label, when it was deleted, and how many days remain before it is permanently purged.

• Restore Deleted

  Undo a delete: restore one soft-deleted post or agent job by type + id (find candidates with list-recently-deleted). Returns 404 if the item is live, already purged, or not in this workspace. Restoring a job does NOT bring back its Hunter/Engager campaign — the response says so when that applies.

• Submit Posts for Review

  Submit one or more posts for team review. Changes post status to 'Pending Approval' and creates TeamPostReview records. Only 'Draft' and 'Needs Revision' posts can be submitted. A post rejected here for being 'Quality Blocked' is NOT a dead end — the per-post result carries quality_block.message with the specific problem; rewrite that post with update-post (which re-runs the check and returns it to Draft when it passes) and submit it again, rather than reporting the block to the user as final.

• Approve Post

  Approve a post that is pending review. Requires admin or owner role. Supports scheduling modes: approve_only, use_suggested_time, or set_fixed_time.