Hive
Server Details
Publish, schedule, analyse and automate DMs across twelve social networks.
Glama couldn't complete the latest health check. If this server requires authentication, missing or expired test credentials may be the cause. A test profile lets Glama authenticate for health checks and discover tools; it is separate from your personal connections.
If you are the author, claim ownership, then add or update a test profile under Admin → Test Profile.
- Status
- Unhealthy
- Uptime
- 11.8% over 25 days
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Scored across 239 tools
With 239 tools, most have clearly distinct purposes and detailed descriptions. Some overlap exists among read tools for inbox and threads (e.g., read_thread, read_community_post, read_inbox_threads), but the descriptions explicitly differentiate conversation types, reducing confusion. Overall, an agent can distinguish tools effectively.
The server predominantly follows a verb_noun pattern (create_, read_, update_, delete_), with some variation like set_, remove_, add_, and archive_. These are still predictable and readable, though the mixing of verbs (set vs update, pause vs resume) is a minor inconsistency.
239 tools is far beyond typical MCP server scope (3-15 tools). Even for a comprehensive product, this is an extreme count that will overwhelm agents and make tool selection impractical, reducing overall coherence.
The tool set covers an extensive range of functionalities including posts, automations, inbox, analytics, bio, podcasts, reviews, advocacy, AI, and more, with create/read/update/delete operations for most entities. It appears to provide a complete lifecycle for the domain, with no obvious dead ends.
Available Tools
244 toolsadd_bio_blockAdd a Hive Bio blockIdempotentInspect
Add one block to the Hive Bio page and save it as a draft. A new block starts switched off until it is finished, and nothing reaches the public page until it is published.
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Which kind of block. Call describe_bio_blocks first if unsure. | |
| title | No | The words on the row. | |
| fields | No | The rest of the block, named as describe_bio_blocks says. | |
| position | No | Where it goes in the list, counted from zero. Leave it out for the end. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
add_competitorTrack a competitorIdempotentInspect
Resolve a public competitor using an accessible connected account and atomically save tracking with its first snapshot. External clients require Hive OAuth; workspace API keys cannot impersonate a signed-in user.
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes | ||
| platform | Yes | ||
| approvalToken | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
add_contact_noteAdd a note to a Hive contactIdempotentInspect
Add a short internal note to one Hive contact. The note is never sent to that person and never leaves the workspace.
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The note, 1 to 4000 characters. | |
| contactId | Yes | The Hive contact identity. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
add_contact_tagTag a Hive contactIdempotentInspect
Add one tag to one Hive contact, by tagId or by its exact name. Tag rules and automations that start on "Tag added" run as they do for a tag added in Hive. Nothing is sent by this call itself.
| Name | Required | Description | Default |
|---|---|---|---|
| tagId | No | The tag to add. Tag ids come from read_contact_operation_settings or the Contacts screen. | |
| tagName | No | The exact tag name, instead of tagId. The tag must already exist. | |
| contactId | Yes | The Hive contact identity. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
add_thread_noteAdd a private note to a Hive conversationIdempotentInspect
Leave an internal note on one Hive Inbox conversation. Only teammates see it; nothing reaches the contact.
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The note, 1 to 4000 characters. | |
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| scope | No | Whether the note belongs to this conversation or to the contact. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
admin_workspace_operationManage another Hive controlDestructiveIdempotentInspect
Manage a Hive administration operation found by list_workspace_operations. Requires the connected owner or admin, the operation’s own granted scope and a separate approval inside Hive for the exact change. The AI cannot approve itself. Requires an OAuth connection.
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Only the editable fields listed for this operation. Hive checks the same rules as its screen. | |
| path | No | The named record ids required by this operation. | |
| query | No | Only the query fields listed for this operation. | |
| operation | Yes | An exact operation id returned by list_workspace_operations. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
approve_postApprove a Hive postDestructiveIdempotentInspect
Approve one Hive post that is waiting for review, after a person approves this exact action in Hive. It must carry the reviewFingerprint from read_pending_approvals, so an edit made after the review was read refuses the approval instead of releasing different content.
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | An optional note for the person who asked. | |
| postId | Yes | The post id from read_pending_approvals. | |
| reviewRunId | Yes | Exact reviewRunId from read_pending_approvals, including null for a single reviewer. | |
| reviewStepId | Yes | Exact reviewStepId from read_pending_approvals, including null for a single reviewer. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| reviewFingerprint | Yes | The reviewFingerprint read_pending_approvals returned for this post. |
archive_flowArchive a Hive automationDestructiveIdempotentInspect
Put one Hive automation away so it is no longer in the working list. Nothing is erased: its saved versions and its history stay, and unarchive_flow restores it without resuming delivery.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to archive. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
assign_reviewAssign a Hive reviewIdempotentInspect
Save a Google review assignment and complete intended Hive workflow state. First read_review; pass the existing labels, channel and status to preserve them. All workflow fields are explicit so an assignment cannot silently clear labels. Nothing is published to Google.
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | The intended workflow status. | |
| labelIds | Yes | The full intended label list; copy existing labels from read_review to preserve them. | |
| channelId | Yes | The existing accessible Hive channel, or null to clear it. | |
| assigneeId | Yes | The current Hive member id, or null to unassign. | |
| reviewName | Yes | The Google review name. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
assign_threadAssign a Hive conversationIdempotentInspect
Assign one Hive Inbox conversation to a teammate or an inbox team, or hand it back to nobody. It sends no message to the contact.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| teamId | No | The inbox team to assign it to. | |
| memberId | No | The teammate to assign it to. Leave both this and teamId out to unassign. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | No | The assignment version you last read, so a teammate’s change is never overwritten. Defaults to 0. |
cancel_jobCancel a background jobDestructiveIdempotentInspect
Request cancellation of a queued or running asynchronous job created by this API connection.
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | Yes | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
cancel_scheduled_postCancel a scheduled Hive postIdempotentInspect
Take a scheduled or approval-pending Hive post out of the queue and return it to drafts. Nothing is deleted. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The Hive post to take out of the queue. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
compare_listeningCompare Hive listening searchesRead-onlyIdempotentInspect
Compare two to five saved Hive listening searches over the same source and the same overlap, from stored mentions only. Searches outside that overlap are named, not counted.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | 7 or 30. Defaults to 7. | |
| queryIds | Yes | Two to five saved search ids. |
create_advanced_viewCreate a Hive advanced report viewIdempotentInspect
Save a Hive advanced view on one report: which posts it keeps and which calculated formulas it adds. It changes nothing a viewer outside Hive can see.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this view. | |
| filters | No | Filters, each with field (platform, channel, tag or media_type), operator (include or exclude) and values. | |
| formulas | No | Formulas, each with label, operator (sum, difference, ratio or average), leftMetric, rightMetric and asPercent. | |
| reportId | Yes | The Hive report id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_advocacy_groupCreate a Hive advocacy groupIdempotentInspect
Create a Hive advocacy group and optionally put workspace members in it. Nobody is messaged by this.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| memberIds | No | Hive member ids to put in the group. | |
| description | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_advocacy_itemCreate Hive advocacy contentIdempotentInspect
Create a Hive employee advocacy item as a draft, with the words, the assets and the suggested copy advocates would share. It is not visible to advocates until someone approves it.
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | ||
| title | Yes | ||
| assetUrls | No | Public asset links advocates can share. | |
| suggestedCopy | No | The caption advocates are offered. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| targetGroupIds | No | Advocacy group ids this item is aimed at. |
create_ai_intentCreate a Hive AI intentIdempotentInspect
Create one intent for the Hive AI studio.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this intent. | |
| status | No | ||
| policyId | No | The AI policy it belongs to. | |
| description | No | What it means. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| negativeExamples | No | Messages that are not. | |
| positiveExamples | Yes | Messages that are this intent. | |
| confidenceThreshold | No | Minimum intent confidence, from 0.5 to 1. |
create_ai_knowledgeAdd Hive AI knowledgeIdempotentInspect
Add one source the Hive AI may answer from. It arrives unapproved, and only an owner or admin can approve it.
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Where it may be used. | |
| title | Yes | What to call this source. | |
| sourceUrl | No | The address, for a url source. | |
| sourceType | Yes | Where the words come from. | |
| storagePath | No | The stored file, for a file source. | |
| freshnessDays | No | How many days before it counts as stale. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| approvedContent | No | The exact words the AI may use. |
create_ai_policyCreate a Hive AI policyIdempotentInspect
Create one Hive AI policy. A new policy is not enabled, so nothing answers from it until an owner or admin enables it.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this policy. | |
| tone | No | How it should sound. | |
| goalEvent | No | Optional goal event, or null to clear it. | |
| languages | No | The languages it may answer in. | |
| policyType | Yes | What kind of policy it is. | |
| instruction | No | What the AI is told to do. | |
| outputSchema | No | The policy output schema stored by Hive. | |
| piiRedaction | No | Redact personal information before evaluation. | |
| allowedTopics | No | What it may talk about. | |
| blockedTopics | No | What it must not. | |
| retentionDays | No | Stored result retention, from 0 to 3650 days. | |
| fallbackAction | No | What it does when it is not sure. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| injectionDefense | No | Enable the native injection checks. | |
| requireCitations | No | Make it cite an approved source. | |
| knowledgeSourceIds | No | Exact knowledge source ids to use; an empty list restores the native default. | |
| confidenceThreshold | No | How sure it must be, from 0 to 1. | |
| providerConnectionId | No | Saved provider connection id, or null for the workspace default. | |
| requireHumanApproval | No | Make a person approve each answer. |
create_approval_workflowCreate a Hive approval workflowIdempotentInspect
Create a Hive approval workflow: the ordered reviewers a post has to pass before it can publish. It decides nothing on its own.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What this workflow is called. | |
| steps | Yes | The reviewers, in order. | |
| active | No | Whether this workflow can be used. | |
| isDefault | No | Use this workflow for every post submitted for approval. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_bio_pageCreate a Hive Bio pageIdempotentInspect
Create this Hive workspace’s first Hive Bio page as a private draft with its address and title. Refuses to replace a page that already exists. Use update_bio_document or the block tools to build it, then publish_bio_page when it is ready.
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | The page title. | |
| username | Yes | The public address to reserve. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_bio_short_linkCreate a Hive short linkIdempotentInspect
Make one of Hive’s own short links for a destination, so its clicks are counted beside the Hive Bio page. Links made outside Hive cannot be created here.
| Name | Required | Description | Default |
|---|---|---|---|
| utm | No | ||
| slug | No | A custom ending, 3 to 64 letters, numbers, hyphens or underscores. Leave it out for a generated one. | |
| tags | No | ||
| title | No | A name for it inside Hive. | |
| domain | No | An active branded domain owned by this workspace; otherwise use its Hive default. | |
| platform | No | Optional social network attribution. | |
| startsAt | No | Optional start time in ISO format. | |
| expiresAt | No | Optional expiry time in ISO format. | |
| campaignId | No | An existing campaign in this workspace; its tracking defaults are merged. | |
| routingRules | No | ||
| socialPostId | No | An existing post you can access in this workspace. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| destinationUrl | Yes | Where the short link goes. A full web address. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_broadcastCreate a Hive broadcast draftIdempotentInspect
Create a Hive broadcast as a draft. It sends nothing: scheduling it is a separate, approved step.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this broadcast. | |
| document | Yes | ||
| timezone | No | The time zone quiet hours are read in. | |
| segmentId | Yes | The Hive segment it goes to. | |
| quietHours | No | ||
| frequencyCap | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| exclusionSegmentIds | No | Segments to leave out. |
create_campaignCreate a campaignIdempotentInspect
Create an organic workspace campaign.
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | ||
| name | Yes | ||
| color | No | ||
| channelIds | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_contactCreate a Hive email contactIdempotentInspect
Create a Hive contact from an email address, or return the one that already has it. Only send emailConsent true when the person really agreed to get emails from you. This sends nothing. People on Instagram, Messenger, WhatsApp and other channels become contacts when they message you.
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | The person’s email address. | ||
| lastName | No | Last name. | |
| firstName | No | First name. | |
| emailConsent | Yes | True only when this person agreed to get emails from you. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_contact_fieldCreate a Hive contact fieldIdempotentInspect
Create one new contact field for this Hive workspace.
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | The stable key automations refer to it by. | |
| type | Yes | What kind of value it holds. | |
| label | Yes | What people see on screen. | |
| options | No | The allowed values, for a choice field. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_default_replyCreate a Hive default replyIdempotentInspect
Create a DM automation default reply in Hive from a saved reply. Setting it active is refused for an account that still needs reconnecting or provider approval.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this default reply. | |
| status | No | Active starts answering real people on the next message. Paused stops replies; draft is a legacy alias for paused. | |
| keywords | No | The words it watches for. | |
| timezone | No | The time zone the hours are read in. | |
| accountIds | Yes | The connected Hive accounts it answers on. | |
| keywordMode | No | How the words are matched, when it watches for words at all. | |
| savedReplyId | Yes | The saved reply whose words it sends. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| businessHours | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| cooldownMinutes | No | Minutes before the same person can be answered again. | |
| firstContactOnly | No | Answer only the first message from a person. | |
| handoffAfterSend | No | Hand the conversation to a person after answering. | |
| businessHoursMode | No | When it is allowed to answer. | |
| maxSendsPerThread | No | How many times one conversation may be answered. |
create_draftCreate a post draft in HiveIdempotentInspect
Create an editable Hive post draft with everything the composer holds: per-network post types and options, Asset Library media, hashtag groups, campaigns and tags. This never publishes and never messages anyone; a person still opens Hive to schedule or publish it.
| Name | Required | Description | Default |
|---|---|---|---|
| cover | No | The composer cover plan. Omit to keep the existing cover; null removes it. | |
| media | No | The photos and videos on the post, in order. | |
| title | No | Shared title. Mainly YouTube. | |
| tagIds | No | Internal tag ids. | |
| caption | No | Shared caption. | |
| privacy | No | Shared privacy, overridden by per-network options when supplied. | |
| hashtags | No | Hashtags appended per network rules. | |
| tagNames | No | Internal tag names. Unknown names are refused with the list of tags that exist. | |
| assigneeId | No | The teammate asked to approve this post. | |
| channelIds | No | The connected Hive accounts this post goes to. | |
| campaignIds | No | Campaign ids. | |
| perPlatform | No | Per-network options keyed by network (instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest, snapchat, bluesky, mastodon, whatsapp, telegram). Each value takes what Hive's composer takes, for example postType (post, reel, story), caption, title, privacy, firstComment, igLocationId, igAltText, igCollaborators, coverUrl, threadsReplyControl, youtubeFormat, tiktokPrivacyLevel. Anything omitted falls back to the shared values. | |
| firstComment | No | A first comment posted under the post where the network supports it. | |
| linkTracking | No | Whether Hive rewrites links for click tracking. Defaults to the workspace setting. | |
| campaignNames | No | Campaign names. Unknown names are refused with the list of campaigns that exist. | |
| hashtagGroupId | No | A saved hashtag group. Its hashtags are merged with any you pass. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| approvalWorkflowId | No | The approval workflow to run instead of the workspace default. |
create_entry_pointCreate a Hive automation entry pointIdempotentInspect
Create a link, QR code or website button that starts one published Hive automation. Instagram Ads sources are prepared from the published automation instead, and Hive says so.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | What kind of entry point this is. | |
| name | Yes | What to call it. | |
| slug | Yes | Required unique slug: 1–64 lowercase letters, numbers or single hyphens. | |
| config | Yes | ||
| flowId | Yes | The published Hive automation it starts. | |
| status | No | Defaults to draft. | |
| accountId | Yes | The connected Hive account it belongs to. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_flowCreate an empty Hive automationIdempotentInspect
Create a new Hive automation as a DRAFT, either empty or from a document you already have. It sends nothing: going live is a separate step a person approves in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this automation. | |
| document | No | A whole automation document to start from, instead of an empty one. | |
| accountId | Yes | The connected Hive account it runs on. | |
| description | No | An optional note about what it is for. | |
| triggerEvent | No | What starts it. Hive also adds one empty message step for you to write, because an automation that starts and does nothing cannot be saved as finished. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_flow_from_briefDraft a Hive automation from a briefIdempotentInspect
Ask Hive’s own AI to draft a new automation from a short brief, and save what it returns as a DRAFT. It sends nothing to anybody: going live is a separate step a person approves in Hive. The connected Hive account is required and is never guessed.
| Name | Required | Description | Default |
|---|---|---|---|
| brief | Yes | What this automation should do, in a few sentences. | |
| context | No | Anything else worth knowing: the offer, the audience, the words to use. | |
| accountId | Yes | The connected Hive account this automation runs on. Use list_connected_accounts to see them; never guess it. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_ideaCreate a content ideaIdempotentInspect
Create an idea in the workspace content board.
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| brief | No | ||
| title | Yes | ||
| channelIds | No | ||
| contentFormat | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_keyword_ruleCreate a Hive automation ruleIdempotentInspect
Create a Hive automation rule from a rule document. A new rule is saved as a draft and does nothing until it is activated.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this rule. | |
| document | Yes | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_listening_alertCreate a Hive listening alertIdempotentInspect
Create or update the Hive mention-spike alert on one saved listening search, with the threshold that counts as a spike. It immediately checks stored observations and reports whether that check succeeded. It sends nothing to anyone outside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | The exact saved search text, resolved after native normalization when queryId is absent. | |
| enabled | No | ||
| queryId | No | The saved search id; alternatively provide its query text. | |
| threshold | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_listening_querySave a Hive listening searchIdempotentInspect
Save a Hive listening search so its mentions are stored from then on. Saving one does not contact a provider by itself.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | What to call it in Hive. | |
| query | Yes | The words to listen for. | |
| windowDays | No | 7 or 30. Defaults to 7. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_planning_cardCreate a Hive planning cardIdempotentInspect
Add a card to a Hive planning board. Pass the expectedVersion you read, so a card someone else added at the same time is never overwritten.
| Name | Required | Description | Default |
|---|---|---|---|
| lane | No | Which lane it starts in. | |
| type | No | The card type, as the board’s existing cards use it. | |
| title | Yes | What the card says. | |
| boardId | Yes | The board id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | Yes | The version read_planning_board returned. |
create_recurring_postCreate a Hive repeating postIdempotentInspect
Create a repeating Hive post series from a pattern, with every composer option. Each occurrence is queued to publish publicly. Your AI asks before this runs; with Hive approvals on, Hive asks again for the exact series.
| Name | Required | Description | Default |
|---|---|---|---|
| cover | No | The composer cover plan. Omit to keep the existing cover; null removes it. | |
| media | No | The photos and videos on the post, in order. | |
| title | No | Shared title. Mainly YouTube. | |
| tagIds | No | Internal tag ids. | |
| caption | No | Shared caption. | |
| privacy | No | Shared privacy, overridden by per-network options when supplied. | |
| hashtags | No | Hashtags appended per network rules. | |
| tagNames | No | Internal tag names. Unknown names are refused with the list of tags that exist. | |
| assigneeId | No | The teammate asked to approve this post. | |
| channelIds | No | The connected Hive accounts this post goes to. | |
| recurrence | Yes | The repeat pattern: frequency, interval, days, the time of day and the timezone, as Hive’s composer sends it. | |
| campaignIds | No | Campaign ids. | |
| perPlatform | No | Per-network options keyed by network (instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest, snapchat, bluesky, mastodon, whatsapp, telegram). Each value takes what Hive's composer takes, for example postType (post, reel, story), caption, title, privacy, firstComment, igLocationId, igAltText, igCollaborators, coverUrl, threadsReplyControl, youtubeFormat, tiktokPrivacyLevel. Anything omitted falls back to the shared values. | |
| firstComment | No | A first comment posted under the post where the network supports it. | |
| linkTracking | No | Whether Hive rewrites links for click tracking. Defaults to the workspace setting. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| campaignNames | No | Campaign names. Unknown names are refused with the list of campaigns that exist. | |
| hashtagGroupId | No | A saved hashtag group. Its hashtags are merged with any you pass. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| approvalWorkflowId | No | The approval workflow to run instead of the workspace default. |
create_reportCreate a saved reportIdempotentInspect
Create a saved analytics report from an existing Hive template.
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| channelIds | No | ||
| templateKey | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_saved_replyCreate a saved replyIdempotentInspect
Create an internal saved reply. This does not send it to anyone.
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| title | Yes | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_segmentCreate a Hive contact segmentIdempotentInspect
Create one contact segment in Hive from a filter.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this segment. | |
| filter | Yes | ||
| description | No | What it is for. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_sequenceCreate a Hive sequenceIdempotentInspect
Create a Hive sequence from a sequence document. It is saved as a draft and sends nothing until it is published.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call this sequence. | |
| document | Yes | ||
| description | No | What it is for. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
create_simple_automationCreate a Hive simple automation draftIdempotentInspect
Build one of the six Hive simple automations and return it as a DRAFT: going live needs the person to open the approval link in Hive. It never messages anyone. It writes the automation, then reports in plain words everything that still blocks Go Live.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional name for the automation. The recipe name is used when omitted. | |
| recipe | Yes | Which Hive simple automation to build. | |
| linkUrl | No | The destination the link message opens. | |
| options | No | ||
| postIds | No | External post ids from read_eligible_posts (or story ids from read_eligible_stories) this automation watches. At most 20. Leave empty to watch every post on the account. | |
| keywords | No | The words a comment or message must contain. | |
| platform | No | The network when accountId is not known yet: instagram, facebook, whatsapp, tiktok, messenger. Hive answers with the accounts to choose from instead of guessing. | |
| accountId | No | The connected Hive account this automation runs on. Leave it out to get the list of accounts to choose from; never guess it. | |
| postScope | No | any watches every post on the account; specific watches only postIds. | |
| replyText | No | The message the automation sends. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| linkButtonLabel | No | The label on the button people tap to ask for the link. | |
| publicReplyText | No | A public reply to the comment. Supplying it switches the public reply step on. |
create_tagCreate a tagIdempotentInspect
Create an internal workspace content tag.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| color | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_ai_intentPause a Hive AI intentDestructiveIdempotentInspect
Pause one Hive AI intent so the AI stops recognising it. Hive keeps the intent rather than erasing what it learned from.
| Name | Required | Description | Default |
|---|---|---|---|
| intentId | Yes | The intent to pause. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_ai_knowledgeArchive Hive AI knowledgeDestructiveIdempotentInspect
Archive one Hive AI knowledge source so the AI stops answering from it.
| Name | Required | Description | Default |
|---|---|---|---|
| knowledgeId | Yes | The source to archive. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_approval_workflowDelete a Hive approval workflowDestructiveIdempotentInspect
Retire one Hive approval workflow so no new post can use it. Posts already in review keep the reviewers they started with.
| Name | Required | Description | Default |
|---|---|---|---|
| workflowId | Yes | The workflow id from read_approval_workflows. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_campaignDelete a Hive campaignDestructiveIdempotentInspect
Delete one Hive campaign. Its posts stay, and lose their campaign grouping and its reporting. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| campaignId | Yes | The campaign id. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_default_replyDelete a Hive default replyDestructiveIdempotentInspect
Delete one Hive DM automation default reply so that rule no longer answers future messages.
| Name | Required | Description | Default |
|---|---|---|---|
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| defaultReplyId | Yes | The default reply to delete. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_draftDelete a Hive draftDestructiveIdempotentInspect
Move a Hive draft or scheduled post to Deleted, where a person can restore it for 30 days. A published post is never touched. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The Hive draft or scheduled post to delete. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_keyword_ruleArchive a Hive automation ruleDestructiveIdempotentInspect
Archive one Hive automation rule. It stops running and leaves the active list.
| Name | Required | Description | Default |
|---|---|---|---|
| ruleId | Yes | The Hive rule to archive. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_keyword_rules returned. |
delete_listening_alertDelete a Hive listening alertDestructiveIdempotentInspect
Delete one Hive mention-spike alert so it stops watching that saved search.
| Name | Required | Description | Default |
|---|---|---|---|
| alertId | Yes | The alert id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_listening_queryDelete a Hive listening searchDestructiveIdempotentInspect
Delete a saved Hive listening search. Its stored mentions stop being collected and the saved search is gone.
| Name | Required | Description | Default |
|---|---|---|---|
| queryId | Yes | The saved search id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_recurring_postCancel a Hive repeating postDestructiveIdempotentInspect
Cancel a repeating Hive post series so no further occurrence is created or published. Posts that already went out are untouched. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| seriesId | Yes | The repeating series to cancel. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_reportDelete a Hive reportDestructiveIdempotentInspect
Delete one saved Hive report and its schedules and shared link. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive, and it cannot be undone.
| Name | Required | Description | Default |
|---|---|---|---|
| reportId | Yes | The Hive report id. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_report_scheduleStop a Hive report emailDestructiveIdempotentInspect
Stop a Hive report email schedule so it sends nothing further. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| reportId | Yes | The Hive report id. | |
| scheduleId | Yes | The schedule id read_report returns. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_saved_replyDelete a Hive saved replyDestructiveIdempotentInspect
Delete one Hive saved reply. It is gone for the whole workspace and cannot be brought back.
| Name | Required | Description | Default |
|---|---|---|---|
| savedReplyId | Yes | The saved reply id from read_saved_replies. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_segmentDelete a Hive contact segmentDestructiveIdempotentInspect
Delete one Hive contact segment. Anything still pointing at it will no longer find an audience.
| Name | Required | Description | Default |
|---|---|---|---|
| segmentId | Yes | The segment to delete. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_tagDelete a Hive tagDestructiveIdempotentInspect
Delete one Hive content tag. Posts stay, and lose that tag and the reporting grouped by it.
| Name | Required | Description | Default |
|---|---|---|---|
| tagId | Yes | The tag id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
delete_thread_noteDelete a private note on a Hive conversationDestructiveIdempotentInspect
Delete an internal note on one Hive Inbox conversation. The note is gone for every teammate and cannot be brought back.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| noteId | Yes | The note id from read_thread_notes. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
describe_bio_blocksDescribe every Hive Bio blockRead-onlyIdempotentInspect
Explain every kind of block a Hive Bio page can hold, the fields each one reads, an example change that works, and anything Hive cannot finish for that kind. Read this before adding or changing a block.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | One kind of block. Leave it out for all of them. |
describe_flow_nodesDescribe the Hive automation stepsRead-onlyIdempotentInspect
List every kind of step a Hive automation can contain, in plain words: what it does, the settings it takes, the values each setting accepts, the outputs it gives, and one working example. Read this before building or changing a Hive automation.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
duplicate_flowCopy a Hive automationIdempotentInspect
Make a copy of one Hive automation as a new DRAFT, so it can be changed without touching the original. The copy sends nothing until a person sets it live in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | What to call the copy. | |
| flowId | Yes | The Hive automation to copy. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
duplicate_postDuplicate a Hive postIdempotentInspect
Copy an existing Hive post into a new draft through native content reuse, preserving its words and copying its media into lasting storage. New composer choices replace previous network options and repeating-series bookkeeping. The copy publishes nothing.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The Hive post to copy. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
enroll_contact_in_sequenceEnroll a contact in a Hive sequenceDestructiveIdempotentInspect
Put one person into the exact published Hive sequence version they reviewed. Read publishedDocument and currentVersion with read_sequence first. This queues real messages to an eligible person, so your AI asks before this runs; with Hive approvals on, Hive asks again inside Hive. A changed publication requires a new review. Contacts without live consent are recorded as stopped_opt_out and receive no messages.
| Name | Required | Description | Default |
|---|---|---|---|
| contactId | Yes | The Hive contact identity to enroll. | |
| sequenceId | Yes | The published Hive sequence. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| entryEventKey | Yes | A caller-generated key of 8 to 180 characters naming why this person is being enrolled. The same key never enrolls the same person twice. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | Yes | The positive currentVersion from read_sequence whose publishedDocument the person reviewed. |
export_reportExport a Hive reportRead-onlyIdempotentInspect
Export one saved Hive report in CSV, XLSX, PDF or PowerPoint. OAuth connections receive the generated file through a private download link that expires after ten minutes. API-key connections receive a signed-in Hive browser link.
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | Which file to produce. Defaults to pdf. | |
| reportId | Yes | The Hive report id. |
fetchFetch one Hive recordRead-onlyIdempotentInspect
Return the full stored record for one id returned by search.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | An id from a search result. |
install_flow_templateInstall a Hive automation templateIdempotentInspect
Install one saved Hive template as a new automation draft. Review its dependencies and warnings before a separately approved publication.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call the new automation. | |
| templateId | Yes | The Hive template to install. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
label_reviewLabel a Hive reviewIdempotentInspect
Save Google review labels and complete intended Hive workflow state. First read_review; pass the existing assignee, channel and status to preserve them. All workflow fields are explicit so labels cannot silently remove an assignment. Nothing is published to Google.
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | The intended workflow status. | |
| labelIds | Yes | The full label list for this review, as read_review_labels returns them. | |
| channelId | Yes | The existing accessible Hive channel, or null to clear it. | |
| assigneeId | Yes | The existing member id, or null to unassign. | |
| reviewName | Yes | The Google review name. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
list_automation_recipesList Hive automation recipesRead-onlyIdempotentInspect
List Hive simple automations and canvas templates with their connector installation controls. Supply recipeId to read one complete template document for editing and saving as a draft.
| Name | Required | Description | Default |
|---|---|---|---|
| recipeId | No | Optional recipe id from this catalog to read one complete canvas template. |
list_connected_accountsList connected Hive accountsRead-onlyIdempotentInspect
List the social accounts connected to this Hive workspace and, for every kind of start an automation can use, whether it can go live on that account right now: with the plain reason when it cannot. No tokens or private messages are returned.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_workspace_operationsFind more Hive controlsRead-onlyIdempotentInspect
Find the additional Hive controls your connection can use, including settings, team administration, content, media, Inbox care, creator partnerships and Hive Bio commerce. Each operation lists its editable fields. Sign-in, card entry and other browser steps are described separately.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Filter by a word such as team, media, booking or settings. | |
| operation | No | Read the complete definition of one operation. |
move_planning_cardMove a Hive planning cardIdempotentInspect
Move one card on a Hive planning board to another lane. Pass the expectedVersion you read, so a change someone else made at the same time is never overwritten.
| Name | Required | Description | Default |
|---|---|---|---|
| lane | Yes | The lane to move it to. | |
| cardId | Yes | The card id. | |
| boardId | Yes | The board id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | Yes | The version read_planning_board returned. |
patch_flowChange part of a Hive automationIdempotentInspect
Make small changes to one Hive automation: add a step, connect two steps, change one setting, move or remove a step. Hive applies them all or none, and saves nothing while anything is wrong. It saves a DRAFT; going live is a separate step a person approves in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| ops | Yes | The changes to make, in order. Hive applies them all or none. | |
| flowId | Yes | The Hive automation to change. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_flow_document returned. | |
| expectedDraftVersionId | Yes | The draftVersionId read_flow_document returned. |
pause_automationPause an automationDestructiveIdempotentInspect
Pause an active or scheduled customer-facing automation and skip its pending outbound actions.
| Name | Required | Description | Default |
|---|---|---|---|
| automationId | Yes | ||
| approvalToken | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
pause_automation_flowPause a live Hive automationDestructiveIdempotentInspect
Pause a live Hive automation so it stops replying to people. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to pause. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
pause_contact_automationsPause every Hive automation for one contactIdempotentInspect
Stop every Hive automation for one person, either until a chosen time or until someone resumes it. Already queued steps for that person stop too; the human Inbox is untouched.
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Why, in plain words, for the people who read this later. | |
| contactId | Yes | The Hive contact identity. | |
| pauseUntil | No | An ISO time in the future, at most a year away. Leave it out to pause until resumed. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
pause_publishingPause Hive publishingDestructiveIdempotentInspect
Stop Hive publishing anything, for the whole workspace or for one connected account, until someone resumes it. Queued posts stay in the queue. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Why publishing is paused, shown to the team. | |
| scopeId | No | The connected account, when scopeType is channel. | |
| scopeType | No | Pause everything, or one connected account. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
preflight_broadcastCheck a Hive broadcast before sendingRead-onlyIdempotentInspect
Check one Hive broadcast draft and return, in plain words, everything that would stop it sending: who it would reach, who would be suppressed and which connected accounts are not ready. This changes nothing and sends nothing.
| Name | Required | Description | Default |
|---|---|---|---|
| broadcastId | Yes | The Hive broadcast to check. |
publish_bio_pagePut the Hive Bio page liveDestructiveIdempotentInspect
Publish the saved Hive Bio draft so the public page shows it. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive. Hive refuses the publish and says why if anything on the page is unfinished or cannot run yet.
| Name | Required | Description | Default |
|---|---|---|---|
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedDraftVersionId | Yes | The draftVersionId from read_bio_page, or publishedVersionId when no draft exists. The exact reviewed version is published. |
publish_nowPublish a Hive post nowDestructiveIdempotentInspect
Publish a Hive post now instead of at its queued time, by running Hive’s own publisher straight away. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive, and the approval is tied to the exact version you read: if the post changes in between, Hive refuses rather than publishing something else. The answer reports only what the post itself says afterwards, so it never claims something went out when it did not.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The Hive post to publish. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | Yes | The version string a Hive read tool returned for this post. Always send it: it ties the approval to the exact words and media the person saw. |
queue_competitor_refreshRefresh competitor dataIdempotentInspect
Queue a refresh for an exact snapshot of all or selected tracked competitors. Hive rechecks connection, membership and source-account access while it runs; saved job results distinguish failures, cancellation and completion.
| Name | Required | Description | Default |
|---|---|---|---|
| approvalToken | No | ||
| competitorIds | No | Optional competitor IDs; omit to select all currently tracked competitors. An empty list selects none. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
rate_ai_replyRate a Hive AI replyIdempotentInspect
Say whether one Hive AI answer was right, with an optional correction. Hive stores this for people to read and never trains on it.
| Name | Required | Description | Default |
|---|---|---|---|
| runId | Yes | The AI run being rated. | |
| rating | Yes | 1 for a good answer, -1 for a bad one. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| correctedAnswer | No | What it should have said. |
read_advanced_viewsRead Hive advanced report viewsRead-onlyIdempotentInspect
Read the saved Hive advanced views: the stored filters and calculated formulas for a report, each with the id create_advanced_view accepts.
| Name | Required | Description | Default |
|---|---|---|---|
| reportId | No | Limit to one Hive report. |
read_advocacyRead employee advocacyRead-onlyIdempotentInspect
Read employee-advocacy content visible to your role and assigned groups.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_advocacy_groupsRead Hive advocacy groupsRead-onlyIdempotentInspect
Read the Hive advocacy groups in this workspace with their descriptions and sizes, each with the id the advocacy tools accept.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_ai_intentsRead Hive AI intentsRead-onlyIdempotentInspect
List the intents this Hive workspace’s AI answers recognise, with their examples and whether each one is enabled.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_ai_knowledgeRead Hive AI knowledgeRead-onlyIdempotentInspect
List the approved sources this Hive workspace’s AI is allowed to answer from, and which of them have gone stale.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_ai_policiesRead Hive AI policiesRead-onlyIdempotentInspect
List this Hive workspace’s AI policies: what each one is allowed to say, how sure it has to be, and what it does when it is not.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_ai_runsRead Hive AI runsRead-onlyIdempotentInspect
List what this Hive workspace’s AI has drafted, with the stored text redacted. Use the run id to rate an answer.
| Name | Required | Description | Default |
|---|---|---|---|
| policyId | No | Only runs under this policy. |
read_analytics_summaryRead analytics summaryRead-onlyIdempotentInspect
Read the latest organic metrics for each connected account, plus recently captured post metrics. Media URLs are not included in this result.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many recent posts to include, 1 to 100. Defaults to 25. | |
| channelIds | No |
read_approval_workflowsRead approval workflowsRead-onlyIdempotentInspect
Read saved Hive workflows with ordered reviewer steps and the latest 100 approval runs. External reviewer details require owner opt-in and follow the workspace masking settings; never copy a masked email into a workflow update. Use read_team for teammate choices.
| Name | Required | Description | Default |
|---|---|---|---|
| includeReviewerDetails | No | Include external reviewer names and email addresses under the workspace private-text sharing and masking settings. |
read_attributionRead Hive attributionRead-onlyIdempotentInspect
Read Hive organic attribution over at most 90 days from the connected Google Analytics 4 property, joined to accessible tracked links. Saved fallback is identified during outages; missing setup and unavailable metrics remain explicit instead of returning zeros.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive ISO end date. | |
| days | No | How many days back to read, when from and to are not given. | |
| from | No | Inclusive ISO start date, for example 2026-09-01. | |
| timeZone | No | IANA time zone the day boundaries are cut on. Defaults to UTC. |
read_automation_flowRead one Hive automationRead-onlyIdempotentInspect
Read one Hive automation: whether it is a draft, live or paused, what starts it, its steps in plain words, when it went live, and what still blocks Go Live while it is a draft.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation id. |
read_automation_resultsRead Hive automation resultsRead-onlyIdempotentInspect
Read the recent runs of one Hive automation with their outcomes and counts, and, when Hive stored an incoming event that started nothing, one plain line saying why it did not fire.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many recent runs to return, from 1 to 100. | |
| flowId | Yes | The Hive automation id. |
read_automationsRead automationsRead-onlyIdempotentInspect
Read comment and DM automation configuration, state, and aggregate results.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_benchmarksRead Hive benchmarksRead-onlyIdempotentInspect
Compare connected Hive accounts against the published network medians when no licensed industry dataset is installed, or compare one account against an imported peer group. Each result identifies its source; missing own metrics remain unknown.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Benchmark window. Defaults to 90. | |
| groupId | No | Optional benchmark peer group id. | |
| channelId | No | The Hive channel to compare. |
read_best_timesRead the best times to post in HiveRead-onlyIdempotentInspect
Read suggested posting times for each connected Hive account, worked out from that account’s own published posts. Every suggestion says whether it came from real evidence or is a neutral default, and an account with too little history says so rather than inventing a time. For the full heatmap with objective, date-window and timezone selection, discover read_best_time_heatmap with list_workspace_operations.
| Name | Required | Description | Default |
|---|---|---|---|
| channelIds | No | Limit the answer to these connected accounts. |
read_bio_audienceRead the Hive Bio audience sizeRead-onlyIdempotentInspect
Read how many contacts the Hive Bio page has collected, grouped by what each one consented to. Contact names, emails and phone numbers are never returned here; read them on the Hive Audience screen.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_bio_insightsRead Hive Bio insightsRead-onlyIdempotentInspect
Read the same Hive Bio report as Hive: page and unique-visitor counts, contact breakdowns, short-link attribution, accessible social-account metrics and explicit missing/truncated evidence. Sample data is labelled; use download_bio_insights for the native CSV.
| Name | Required | Description | Default |
|---|---|---|---|
| range | No | How far back to look. Defaults to 28d. | |
| sample | No | Use 1 only for labelled sample data. | |
| dashboard | No | Use 1 for the lighter native dashboard report. |
read_bio_pageRead the Hive Bio pageRead-onlyIdempotentInspect
Read this Hive workspace’s Hive Bio page: the profile, the header, the look, and every block with its id, kind, title, whether it is shown, where it sits and whether it is finished. Also gives the saved draft version, the live version and the public address.
| Name | Required | Description | Default |
|---|---|---|---|
| includeArchived | No | Include blocks that were archived. Off by default. |
read_bio_qrRead the Hive Bio QR code addressRead-onlyIdempotentInspect
Give the Hive address that draws a QR code for the Hive Bio page, or for one row on it. For the actual PNG or SVG file, discover download_bio_qr with list_workspace_operations.
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | The picture format the address returns. Defaults to png. | |
| blockId | No | One block on the page, for a code that points at that row. Leave it out for the whole page. |
read_bio_short_linksRead Hive short linksRead-onlyIdempotentInspect
Read the complete native short-link list, including schedules, routing, tags, attribution and click evidence. Optionally request a bounded window using limit and offset; nextOffset continues it. Like Hive, this may refresh up to 20 stale Bitly click caches and reports failures explicitly.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional window size, 1 to 200. Omit for the complete list. | |
| offset | No | Optional starting offset; use nextOffset from the previous result. |
read_bot_fieldsRead Hive bot fieldsRead-onlyIdempotentInspect
Read this Hive workspace’s bot fields: values shared by every automation, not tied to one person, with their current values.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_broadcastRead one Hive broadcastRead-onlyIdempotentInspect
Read one Hive broadcast: its audience, its content, its schedule and the stored evidence of what it has sent.
| Name | Required | Description | Default |
|---|---|---|---|
| broadcastId | Yes | The Hive broadcast to read. |
read_broadcastsRead Hive broadcastsRead-onlyIdempotentInspect
List this Hive workspace’s broadcasts with their status, audience segment and schedule, plus the segments and accounts a new one can use.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_calendarRead the publishing calendarRead-onlyIdempotentInspect
Read scheduled, draft, approval, failed and recently published workflow items.
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| channelIds | No |
read_campaigns_and_tagsRead campaigns and tagsRead-onlyIdempotentInspect
List campaigns and internal post tags.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_channel_healthRead Hive channel healthRead-onlyIdempotentInspect
Read every account connected to this Hive workspace in plain words: whether it is connected or needs reconnecting, when Hive last checked, and what it can do right now. Connecting or reconnecting uses the network sign-in in Hive at /channels. Use list_workspace_operations for approved social-account and Telegram disconnection; Instagram removal requires its impact review and exact Hive approval.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_channel_reportRead a Hive performance reportRead-onlyIdempotentInspect
Read one Hive performance report over a date range: posts, accounts, inbox or campaigns. Every number carries the provider snapshot and the exact range behind it, and a channel Hive could not read is listed with the reason, never as a zero.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive ISO end date. | |
| days | No | How many days back to read, when from and to are not given. | |
| from | No | Inclusive ISO start date, for example 2026-09-01. | |
| timeZone | No | IANA time zone the day boundaries are cut on. Defaults to UTC. | |
| objective | No | Which report to read. Defaults to posts. | |
| channelIds | No | Limit to these Hive channel ids. |
read_channelsRead connected channelsRead-onlyIdempotentInspect
List connected organic channels and their connection health. No tokens or secrets are returned.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_channel_settingsRead Hive channel settingsRead-onlyIdempotentInspect
Read one connected account’s Hive settings: its time zone, its posting schedule slots, its weekly goal and its general details.
| Name | Required | Description | Default |
|---|---|---|---|
| channelId | Yes | The Hive channel id. |
read_community_postRead one Hive community conversationRead-onlyIdempotentInspect
Read one public comment conversation in the Hive Inbox with its messages in order. Reading it here does not mark it read in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| threadId | Yes | The conversation id. |
read_community_postsRead Hive community conversationsRead-onlyIdempotentInspect
Read the public comment conversations in the Hive Inbox with their status, account and latest activity, each with the id read_community_post accepts.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many to return, 1 to 200. Defaults to 50. | |
| filter | No | Which conversations to read. Defaults to all. |
read_competitorsRead tracked competitorsRead-onlyIdempotentInspect
Read Hive competitor tracking with the latest 90 saved snapshots per competitor, recent public posts, freshness, available platforms and management access. Reads stored evidence without refreshing providers.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_contactRead one Hive automation contactRead-onlyIdempotentInspect
Read one person Hive has spoken to: their stored field values, their consent, and their consent history. Text follows the workspace Inbox privacy setting.
| Name | Required | Description | Default |
|---|---|---|---|
| contactId | Yes | The Hive contact identity to read. |
read_contact_fieldsRead Hive contact fieldsRead-onlyIdempotentInspect
List the contact fields this Hive workspace stores about people, and what kind of value each one holds.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_contactsRead Hive automation contactsRead-onlyIdempotentInspect
List the people this Hive workspace has spoken to through DM automation, sequences, broadcasts and the Inbox. Names, handles and stored values follow the workspace Inbox privacy setting, so they may come back masked. The included-contact allowance comes back with every answer.
| Name | Required | Description | Default |
|---|---|---|---|
| No | Find people by exact email address. Use only one of email, phone or fieldId. | ||
| limit | No | How many people to return, 1 to 100. Defaults to 25. | |
| phone | No | Find people by exact phone number in international format, like +14155550123. | |
| search | No | Match a name, handle or provider id. | |
| fieldId | No | Find people whose contact field has exactly fieldValue. Field ids come from read_contact_fields. | |
| accountId | No | Only people on this connected account’s platform. | |
| fieldName | No | The field’s key or name, instead of fieldId. | |
| segmentId | No | Only people in this Hive segment. | |
| fieldValue | No | The value to match in fieldId. |
read_content_pageRead a page of contentRead-onlyIdempotentInspect
Read an opaque cursor-paginated page of posts, ideas, or campaigns without changing the legacy list tools.
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque nextCursor from the previous page. | |
| pageSize | No | 1 to 100 items. | |
| resource | Yes |
read_deep_reportRead a Hive deep reportRead-onlyIdempotentInspect
Read the Hive deep report sections: competitors, tags, customer care and satisfaction. A section whose storage is not installed says so in plain words rather than reporting an empty result as a finding.
| Name | Required | Description | Default |
|---|---|---|---|
| section | No | Which section to read. Defaults to all. |
read_default_repliesRead Hive default repliesRead-onlyIdempotentInspect
Read Hive automatic replies, all saved rule settings and template text, accessible account choices, setup readiness and recent activity. Rules may match keywords or use a default response; nothing is sent by this read.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_eligible_postsList posts an automation can watchRead-onlyIdempotentInspect
List the published posts on one connected account that a comment automation can watch. Use it before building a comment automation on specific posts; scheduled or unpublished posts cannot be watched yet.
| Name | Required | Description | Default |
|---|---|---|---|
| accountId | Yes | The connected account whose published posts, reels or videos can be watched. |
read_eligible_storiesList stories an automation can watchRead-onlyIdempotentInspect
List the Instagram stories currently live on one connected account that a story reply automation can watch. A story binding stops when the story expires, 24 hours after it was posted.
| Name | Required | Description | Default |
|---|---|---|---|
| accountId | Yes | The connected Instagram account whose current stories can be watched. |
read_entry_point_qrRead a Hive entry point QR linkRead-onlyIdempotentInspect
Return the public link behind one Hive entry point and the Hive address that downloads its QR code. The image itself is downloaded from Hive, not returned here.
| Name | Required | Description | Default |
|---|---|---|---|
| entryPointId | Yes | The entry point. |
read_entry_pointsRead Hive automation entry pointsRead-onlyIdempotentInspect
List up to 200 recently updated Hive workspace entry points filtered to accounts you can access: links, QR codes and website buttons, their saved customization and routing status.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_flow_documentRead one Hive automation in fullRead-onlyIdempotentInspect
Return the whole saved document for one Hive automation, plus a plain sentence for what starts it and for each step, the ids needed to save a change, and everything that would stop it going live.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to read. |
read_flow_templatesRead Hive automation templatesRead-onlyIdempotentInspect
List this Hive workspace’s saved automation templates, what each one needs to work, and any warning about installing it elsewhere.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_flow_versionsList the saved versions of a Hive automationRead-onlyIdempotentInspect
List the saved versions of one Hive automation, newest first, so an earlier one can be restored.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to read. |
read_inbox_analyticsRead Hive Inbox reportingRead-onlyIdempotentInspect
Read the Hive Inbox team report: volumes, response and resolution times, backlog and per-teammate workload over the chosen window. Durations Hive could not measure are returned empty with their sample size, never as zero.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Reporting window in days. Defaults to 30. |
read_inbox_summaryRead inbox summaryRead-onlyIdempotentInspect
Read aggregate inbox status counts only. Never returns DMs, message bodies, contact PII, or private records.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_inbox_threadsRead inbox threadsRead-onlyIdempotentInspect
Read owner-enabled, redacted Inbox threads. This read does not return private notes or original unmasked text. For explicitly authorized originals, discover the reveal_inbox operations with list_workspace_operations; they require private-text sharing, native reveal permission and a successful audit.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
read_inbox_viewsRead saved Hive Inbox viewsRead-onlyIdempotentInspect
Read the saved Hive Inbox views in this workspace: their name, who can see them and the filters each one applies.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_job_pageRead a page of background jobsRead-onlyIdempotentInspect
Read an opaque cursor-paginated page of asynchronous developer jobs.
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque nextCursor from the previous page. | |
| pageSize | No | 1 to 100 items. |
read_jobsRead background jobsRead-onlyIdempotentInspect
Read recent asynchronous developer jobs and their progress.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
read_keyword_rulesRead Hive automation rulesRead-onlyIdempotentInspect
List this Hive workspace’s automation rules: what starts each one, what it does, whether it is active, when it last ran and anything it last failed on.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_listeningRead social listeningRead-onlyIdempotentInspect
Read saved listening queries, provider coverage, and aggregate snapshot metrics.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_listening_alertsRead Hive listening alertsRead-onlyIdempotentInspect
Read the Hive mention-spike alerts on this workspace with their thresholds, state and the spikes they have already reported.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_listening_benchmarksRead Hive listening benchmarksRead-onlyIdempotentInspect
Compare one saved Hive listening search against up to four competitor searches, from stored mentions only, with the coverage behind every row.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | 7 or 30. Defaults to 7. | |
| brandQueryId | Yes | The saved search that stands for your brand. | |
| competitorQueryIds | Yes | One to four competitor search ids. |
read_listening_forecastRead a Hive listening forecastRead-onlyIdempotentInspect
Read the Hive projection for one saved listening search from its stored history. History that is short, mixed, old or incomplete returns "not enough data" with the reason rather than a number.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Forecast horizon, 7 or 30. Defaults to 7. | |
| queryId | Yes | The saved search id. |
read_listening_trendsRead Hive listening trendsRead-onlyIdempotentInspect
Read the rising and falling terms in one saved Hive listening search, from stored mentions only. Returns the same native and licensed trend groups as Hive, with their separate evidence windows and full coverage disclosure.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | 7 or 30. Defaults to 7. | |
| query | Yes | The saved search words. |
read_media_libraryRead the Hive Asset LibraryRead-onlyIdempotentInspect
List the photos and videos saved in this Hive workspace, with their folders. Pass an id back as a media assetId when composing a post.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many items to return, 1 to 200. Defaults to 100. | |
| folderId | No | Only items in this folder. |
read_pending_approvalsRead Hive posts waiting for approvalRead-onlyIdempotentInspect
List the Hive posts waiting for a decision, with who asked, which accounts they go to, the start of the caption, and the reviewFingerprint that any approval or rejection must carry so the decision binds the exact content that was reviewed.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many posts to return, from 1 to 100. |
read_planning_boardRead one Hive planning boardRead-onlyIdempotentInspect
Read one Hive planning board: its lanes, its cards and the version number the card tools need in order to write safely.
| Name | Required | Description | Default |
|---|---|---|---|
| boardId | Yes | The board id. |
read_planning_boardsRead Hive planning boardsRead-onlyIdempotentInspect
Read the Hive campaign planning boards in this workspace with their campaigns and versions, each with the id the board tools accept.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_portfolioRead permitted workspacesRead-onlyIdempotentInspect
List the connected user's permitted Hive workspaces for Queen multi-brand routing.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_post_performanceRead Hive post performanceRead-onlyIdempotentInspect
Read the Hive cross-network post performance table: one row per published post with its account, media type, campaign, tags and canonical metrics. Every row says which provider snapshot it came from and when it was captured; a post whose metrics were never captured says so instead of showing zeros. This summary returns at most 200 rows. For the complete native table, discover read_post_performance_dataset with list_workspace_operations.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive ISO end date. | |
| days | No | How many days back to read, when from and to are not given. | |
| from | No | Inclusive ISO start date, for example 2026-09-01. | |
| sort | No | Which column to sort by, highest first. Defaults to published. | |
| limit | No | How many rows to return, 1 to 200. Defaults to 50. | |
| timeZone | No | IANA time zone the day boundaries are cut on. Defaults to UTC. | |
| channelIds | No | Limit to these Hive channel ids. Omit for every account you can see. |
read_postsRead postsRead-onlyIdempotentInspect
Read public canonical post history for evidence, pattern analysis, and repurposing. Date filters apply to the native publication time.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum posts to return, from 1 to 250. | |
| dateTo | No | Inclusive ISO publication-date upper bound. | |
| dateFrom | No | Inclusive ISO publication-date lower bound. | |
| channelIds | No |
read_pricingRead what Hive Publish costsRead-onlyIdempotentInspect
What Hive Publish costs: every plan with its price, what the free tier includes, the 14-day trial, and how the price is counted. Use this whenever someone asks about cost, plans, the trial or how Hive Publish compares with another tool on price. Never state a Hive Publish price that did not come from here.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_product_knowledgeRead Hive product guidanceRead-onlyIdempotentInspect
Read current Hive guidance, the tools available to this connection, their confirmation and Hive approval policies, and how to discover additional workspace operations. Guidance revision is separate from deployment, plugin and directory-review dates. Use this and tools/list before quoting counts or claiming a screen is unsupported.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_queueRead the Hive publishing queueRead-onlyIdempotentInspect
Read the Hive posts waiting to publish, soonest first, with their run times, accounts and status. Each one carries a version string that publish_now needs.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many posts to return, 1 to 200. Defaults to 50. | |
| channelIds | No | Only posts going to these accounts. |
read_recommendationsRead Hive analytics recommendationsRead-onlyIdempotentInspect
Read the deterministic Hive recommendations for this workspace: what changed against the previous period, the evidence behind each one, and the channels whose evidence is missing or stale.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive ISO end date. | |
| days | No | How many days back to read, when from and to are not given. | |
| from | No | Inclusive ISO start date, for example 2026-09-01. | |
| timeZone | No | IANA time zone the day boundaries are cut on. Defaults to UTC. |
read_recurring_postsRead Hive repeating postsRead-onlyIdempotentInspect
Read a summary of up to 100 Hive repeating series and 500 stored occurrences across them; captions are abbreviated. Discover read_recurring_post_details with list_workspace_operations for the native list with full saved templates and management permissions.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_reportRead one Hive reportRead-onlyIdempotentInspect
Read one saved Hive report: its title, date period, channels and every widget in it, with the id each other report tool accepts.
| Name | Required | Description | Default |
|---|---|---|---|
| reportId | Yes | The Hive report id. |
read_report_dataRead a Hive report’s dataRead-onlyIdempotentInspect
Read the data behind one saved Hive report: the accounts, posts and stored snapshots its widgets render from. Media URLs are not included.
| Name | Required | Description | Default |
|---|---|---|---|
| reportId | Yes | The Hive report id. |
read_reportsRead saved reportsRead-onlyIdempotentInspect
List saved report definitions and delivery-safe metadata.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_report_schedulesRead report schedulesRead-onlyIdempotentInspect
Read configured report delivery schedules without exposing recipient addresses.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_resolution_reasonsRead Hive resolution reasonsRead-onlyIdempotentInspect
Read the reasons this Hive workspace can close an Inbox conversation with. Use one of these ids when resolving a conversation.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_reviewRead one Hive reviewRead-onlyIdempotentInspect
Read one Google review Hive is working on: its stored workflow status, who it is assigned to, its labels and its reply history, plus the live review text when the Google connection can be read. When it cannot, the result says why instead of leaving the words out silently.
| Name | Required | Description | Default |
|---|---|---|---|
| reviewName | Yes | The Google review name, as read_reviews returns it. |
read_review_labelsRead Hive review labelsRead-onlyIdempotentInspect
Read the Hive review labels in this workspace, each with the id label_review accepts.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_reviewsRead review operationsRead-onlyIdempotentInspect
Read review operations and assignment state. Provider-live review bodies and reviewer identities remain excluded.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_saved_repliesRead Hive saved repliesRead-onlyIdempotentInspect
Read this workspace’s saved Hive Inbox replies. These are internal templates, so nothing here has been sent to anyone.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Optional text to match in saved reply titles or bodies. |
read_segmentsRead Hive contact segmentsRead-onlyIdempotentInspect
List this Hive workspace’s contact segments and the filter behind each one. A broadcast is addressed to a segment.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_sequenceRead one Hive sequenceRead-onlyIdempotentInspect
Read one Hive sequence: its steps, its published version, and the stored evidence of what it has actually sent.
| Name | Required | Description | Default |
|---|---|---|---|
| sequenceId | Yes | The Hive sequence to read. |
read_sequencesRead Hive sequencesRead-onlyIdempotentInspect
List this Hive workspace’s sequences with their status and current version. A sequence sends its messages over days, so only a published one is sending anything.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_teamRead the Hive workspace teamRead-onlyIdempotentInspect
List the people in this Hive workspace with their id, name and role. Email addresses are not returned.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_team_rolesRead Hive workspace rolesRead-onlyIdempotentInspect
List this Hive workspace’s roles, what each one is allowed to do, and which role every teammate holds.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
read_threadRead one Hive Inbox conversationRead-onlyIdempotentInspect
Read one Hive Inbox conversation and its messages. Message text is returned only while the workspace allows outside AI to read it; otherwise the tool says so and returns no message text.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| threadId | Yes | The conversation id. |
read_thread_notesRead the private notes on a Hive conversationRead-onlyIdempotentInspect
Read the internal notes teammates left on one Hive Inbox conversation. Notes are returned only while the workspace allows outside AI to read message text, and always redacted.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| threadId | Yes | The conversation id. |
read_workspace_operationRead another Hive controlInspect
Read a Hive operation found by list_workspace_operations. Uses the connected person and workspace, with the same permissions as Hive. Large results and downloads create temporary private files. Each operation also needs its own granted read scope. Requires an OAuth connection.
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Only the editable fields listed for this operation. Hive checks the same rules as its screen. | |
| file | No | An attached file for an operation explicitly advertising file inspection. Other read operations reject files. | |
| path | No | The named record ids required by this operation. | |
| query | No | Only the query fields listed for this operation. | |
| operation | Yes | An exact operation id returned by list_workspace_operations. |
read_workspace_resultRead a complete Hive resultRead-onlyIdempotentInspect
Read a page or JSON pointer from a large result already returned by a Hive operation. Uses the same OAuth person, workspace and connection; rechecks the original operation’s scope, permissions, plan, privacy and account grants. Never repeats the original action. Concatenate json pages using nextOffset before parsing.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum UTF-16 characters in the JSON text page, from 1 to 16000. | |
| offset | No | Character offset from the previous page’s nextOffset; defaults to 0. | |
| pointer | No | Optional JSON pointer such as /report/rows/0; empty text selects the entire result. | |
| download | No | Return a private expiring link to the complete sanitized JSON result instead of a page. | |
| resultId | Yes | The temporary resultId returned by the original operation. |
reject_postReject a Hive postDestructiveIdempotentInspect
Reject one Hive post that is waiting for review, after a person approves this exact action in Hive. A note is required so the person who asked knows why.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The post id from read_pending_approvals. | |
| reason | Yes | Why it is rejected. The person who asked reads this. | |
| reviewRunId | Yes | Exact reviewRunId from read_pending_approvals, including null for a single reviewer. | |
| reviewStepId | Yes | Exact reviewStepId from read_pending_approvals, including null for a single reviewer. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| reviewFingerprint | Yes | The reviewFingerprint read_pending_approvals returned for this post. |
remove_bio_blockRemove a Hive Bio blockIdempotentInspect
Take one block off the Hive Bio page and save it as a draft. By default it is archived and can be brought back. Deleting it for good is a separate choice and cannot be undone.
| Name | Required | Description | Default |
|---|---|---|---|
| hard | No | True deletes the block for good instead of archiving it. It cannot be brought back. | |
| blockId | Yes | The id read_bio_page gave for this block. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
remove_competitorStop tracking a Hive competitorDestructiveIdempotentInspect
Stop tracking one public competitor in Hive and remove its stored snapshots. Nothing on the competitor’s own account changes.
| Name | Required | Description | Default |
|---|---|---|---|
| competitorId | Yes | The competitor id read_competitors returns. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
remove_contact_tagRemove a tag from a Hive contactDestructiveIdempotentInspect
Remove one tag from one Hive contact, by tagId or by its exact name. Tag rules and automations that start on "Tag removed" run as they do in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| tagId | No | The tag to remove. | |
| tagName | No | The exact tag name, instead of tagId. | |
| contactId | Yes | The Hive contact identity. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
rename_flowRename a Hive automationIdempotentInspect
Change the name or the description of one Hive automation. It changes the DRAFT only and sends nothing; going live is a separate step a person approves in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The new name. | |
| flowId | Yes | The Hive automation to rename. | |
| description | No | The new description. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_flow_document returned. | |
| expectedDraftVersionId | Yes | The draftVersionId read_flow_document returned. |
reopen_threadReopen a Hive conversationIdempotentInspect
Move one resolved Hive Inbox conversation back to open. It sends no message to the contact.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | No | The resolution version you last read. Defaults to 0. |
reorder_bio_blocksMove a Hive Bio blockIdempotentInspect
Move one block up or down the Hive Bio page, or into and out of a collection, and save it as a draft. Visitors read the page in this order.
| Name | Required | Description | Default |
|---|---|---|---|
| blockId | Yes | The block to move. | |
| placement | Yes | before or after the target block, or top or bottom of the page. | |
| targetBlockId | No | The block to move it next to. Not needed for top or bottom. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
reply_to_commentReply to a commentIdempotentInspect
Post a public reply to an existing Hive Community comment. Supply expectedVersion and UUID clientRequestId together for collision protection; careRelease may carry a reviewed care reply. Native account permissions and release checks apply. Provider acceptance with local save issues is reported as delivered; do not resend.
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| threadId | Yes | ||
| careRelease | No | ||
| approvalToken | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| clientRequestId | No | ||
| expectedVersion | No |
reply_to_reviewReply to a Hive reviewDestructiveIdempotentInspect
Publish a reply to one Google review from the connected business profile. The reply is public on Google under the business name, so your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| comment | Yes | The words of the reply. | |
| reviewName | Yes | The Google review name. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
request_changes_on_postAsk for changes on a Hive postDestructiveIdempotentInspect
Send one Hive post back for changes, after a person approves this exact action in Hive. A note is required so the person who asked knows what to change.
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | What has to change. The person who asked reads this. | |
| postId | Yes | The post id from read_pending_approvals. | |
| reviewRunId | Yes | Exact reviewRunId from read_pending_approvals, including null for a single reviewer. | |
| reviewStepId | Yes | Exact reviewStepId from read_pending_approvals, including null for a single reviewer. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| reviewFingerprint | Yes | The reviewFingerprint read_pending_approvals returned for this post. |
request_post_approvalSend a Hive post for approvalIdempotentInspect
Put a Hive draft in front of the workspace’s approvers so a person can decide on it. It publishes nothing by itself: a person still approves it in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The Hive draft to send for review. | |
| assigneeId | No | One teammate to ask, instead of every approver. | |
| workflowId | No | The selected approval workflow; omitted uses the workspace default. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
reschedule_postReschedule a Hive postIdempotentInspect
Move an existing Hive draft or scheduled post through the native calendar using a Hive OAuth connection. Failed posts must use the native Retry failed action so completed destinations, reconnect checks and repeating-series state stay protected.
| Name | Required | Description | Default |
|---|---|---|---|
| runAt | Yes | The new time, as an ISO date in the future. | |
| postId | Yes | The Hive post to move. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
resolve_threadResolve a Hive conversationIdempotentInspect
Close one Hive Inbox conversation with a resolution reason from read_resolution_reasons. It sends no message to the contact.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| reasonId | Yes | A resolution reason id from read_resolution_reasons. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | No | The resolution version you last read. Defaults to 0. |
resolve_threadsResolve several Hive conversationsIdempotentInspect
Close up to 50 Hive Inbox conversations of the same kind with one resolution reason. It is all or nothing: if one cannot be closed, none are. It sends no message to anyone.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| items | Yes | The conversations to close, with the version you last read for each. | |
| reasonId | Yes | A resolution reason id from read_resolution_reasons. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
restore_deleted_postRestore a deleted Hive postIdempotentInspect
Bring a Hive post back from Deleted, to Drafts or to the Queue depending on where it came from. Restoring a queued post resumes public publishing at its saved time. Your AI asks before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| postId | Yes | The deleted Hive post to bring back. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
restore_flow_versionRestore an earlier Hive automation versionIdempotentInspect
Bring one earlier saved version of a Hive automation back as the current DRAFT. Nothing is erased and nothing goes live: setting it live is a separate step a person approves in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to restore into. | |
| versionId | Yes | The version to restore, from read_flow_versions. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedDraftRevision | No | The revision read_flow_document returned, or leave it out when there is no draft. | |
| expectedDraftVersionId | No | The draftVersionId read_flow_document returned, or leave it out when there is no draft. |
resume_contact_automationsResume Hive automations for one contactIdempotentInspect
Let Hive automations reach one person again after a pause.
| Name | Required | Description | Default |
|---|---|---|---|
| contactId | Yes | The Hive contact identity. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
resume_publishingResume Hive publishingIdempotentInspect
Let Hive publish again after a pause, for the whole workspace or for one connected account. Posts whose time already passed go out at the next run. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| scopeId | No | The connected account, when scopeType is channel. | |
| scopeType | No | Resume everything, or one connected account. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
schedule_postSchedule a Hive postIdempotentInspect
Put a post in Hive’s queue for a future time, with every composer option. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive, because it will be published publicly. Hive checks every target network before it writes anything, so a post a network would reject is refused here instead of failing later.
| Name | Required | Description | Default |
|---|---|---|---|
| cover | No | The composer cover plan. Omit to keep the existing cover; null removes it. | |
| media | No | The photos and videos on the post, in order. | |
| runAt | Yes | When to publish, as an ISO date in the future. | |
| title | No | Shared title. Mainly YouTube. | |
| postId | No | An existing Hive draft to schedule. Leave it out to create and schedule in one step. | |
| tagIds | No | Internal tag ids. | |
| caption | No | Shared caption. | |
| privacy | No | Shared privacy, overridden by per-network options when supplied. | |
| hashtags | No | Hashtags appended per network rules. | |
| tagNames | No | Internal tag names. Unknown names are refused with the list of tags that exist. | |
| assigneeId | No | The teammate asked to approve this post. | |
| channelIds | No | The connected Hive accounts this post goes to. | |
| recurrence | No | A repeat pattern. Supplying it creates a repeating series whose first post is the next occurrence. | |
| campaignIds | No | Campaign ids. | |
| perPlatform | No | Per-network options keyed by network (instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest, snapchat, bluesky, mastodon, whatsapp, telegram). Each value takes what Hive's composer takes, for example postType (post, reel, story), caption, title, privacy, firstComment, igLocationId, igAltText, igCollaborators, coverUrl, threadsReplyControl, youtubeFormat, tiktokPrivacyLevel. Anything omitted falls back to the shared values. | |
| firstComment | No | A first comment posted under the post where the network supports it. | |
| linkTracking | No | Whether Hive rewrites links for click tracking. Defaults to the workspace setting. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| campaignNames | No | Campaign names. Unknown names are refused with the list of campaigns that exist. | |
| hashtagGroupId | No | A saved hashtag group. Its hashtags are merged with any you pass. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | No | Required with postId: the exact version returned by read_post for the content being approved. Changed content requires a fresh review. | |
| approvalWorkflowId | No | The approval workflow to run instead of the workspace default. |
schedule_report_emailSchedule a Hive report emailIdempotentInspect
Set up a recurring Hive email delivery for one saved report: who receives it, how often and in which format. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive, because it sends email on its own afterwards.
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | Which file is attached. Defaults to pdf. | |
| cadence | Yes | How often it is sent. | |
| reportId | Yes | The Hive report id. | |
| sendTime | No | Local send time as HH:MM. | |
| timezone | No | IANA time zone the send time is read in. | |
| dayOfWeek | No | 0 to 6, for a weekly cadence. | |
| dayOfMonth | No | 1 to 28, for a monthly cadence. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| externalRecipients | No | Email addresses outside the workspace. These need the plan feature for outside delivery and the owner’s approval. | |
| internalRecipientIds | No | Hive member ids who receive it. | |
| externalRecipientsApproved | No | Set true only when the person has approved sending outside the workspace. |
searchSearch HiveRead-onlyIdempotentInspect
Search this workspace’s posts, ideas and campaigns by keyword. Returns an id, a title and a link for each match; pass an id to fetch for the full record.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to look for. |
search_inboxSearch the Hive InboxRead-onlyIdempotentInspect
Search this workspace’s Hive Inbox conversations and return each one’s id, account, status, who it is assigned to and when it last moved. Contact names and message text are returned only while the workspace allows outside AI to read them, and always redacted.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Which kind of conversation this is: dm, comment or mention. | |
| limit | No | How many conversations to return, from 1 to 50. | |
| query | No | Words to look for. Leave it out to list the most recent conversations. | |
| status | No | Only open conversations, or only resolved ones. | |
| channelIds | No | Only these connected accounts. |
send_direct_messageSend a direct messageIdempotentInspect
Send a direct message using the connected Community account permissions and allowed reply window. Meta requires a saved conversation; TikTok protects repeated attempts. Reuse the same request key when retrying; do not resend a delivered message when Hive reports a local save issue.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| channelId | Yes | ||
| recipientId | Yes | ||
| approvalToken | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_advocacy_lifecycleMove Hive advocacy contentDestructiveIdempotentInspect
Move one Hive advocacy item through its approval steps: submit, approve, reject, archive or set an expiry. Approving publishes it to the advocates in its groups, so your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Which step to take. approve is the one that publishes it to advocates. | |
| reason | No | Why, for the approval history. | |
| contentId | Yes | The advocacy item id. | |
| expiresAt | No | ISO time the item stops being offered. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_automation_liveSet a Hive automation liveDestructiveIdempotentInspect
Set one saved Hive automation live so it starts replying to real people. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive; the approval page shows them the account, what starts it and every message. Pass both the draftVersionId and revision you read; Hive refuses if either changed before publication.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to set live. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision returned with the draftVersionId you reviewed. Edits to the same saved draft change this revision. | |
| expectedVersionId | Yes | The draftVersionId returned by read_automation_flow, create_simple_automation or update_simple_automation. Always send it: the approval is tied to that exact saved version, so if the automation changes after the person reads it, Hive refuses instead of setting something else live. |
set_bio_designSet the Hive Bio lookIdempotentInspect
Change how the Hive Bio page looks: its theme and its typeface. A theme or typeface Hive does not have is refused by name rather than quietly ignored. Saved as a draft.
| Name | Required | Description | Default |
|---|---|---|---|
| themeId | No | A Hive theme id. read_bio_page names the one in use. | |
| fontFamily | No | A Hive typeface id for the page text. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_bio_headerSet the Hive Bio headerIdempotentInspect
Change the top of the Hive Bio page: the name shown, the line under it, and the header layout. Saved as a draft.
| Name | Required | Description | Default |
|---|---|---|---|
| bio | No | The line under the name. | |
| layout | No | The header style. | |
| displayName | No | The name shown at the top. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_bio_profileSet the Hive Bio profileIdempotentInspect
Change the Hive Bio address, page title and description. Changing the address changes where the public page lives, so anyone who saved the old one will not find it. Saved as a draft.
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | The page title. | |
| username | No | The public address, letters, numbers, dots, underscores and hyphens. | |
| description | No | The description Hive shows with the page. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_bot_fieldsSave Hive bot field valuesIdempotentInspect
Save one or many Hive bot field values, shared by every automation, by field id or by name. Send one field and its value, or fields for up to 20 at once. Every value is checked before any is saved.
| Name | Required | Description | Default |
|---|---|---|---|
| value | No | The value to store in the field. | |
| fields | No | Up to 20 bot fields to set in one call, instead of one field and value. | |
| fieldId | No | The bot field to set. Bot field ids come from read_bot_fields. | |
| fieldName | No | The bot field’s key or name, instead of fieldId. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_broadcast_statusSet a Hive broadcast statusDestructiveIdempotentInspect
Schedule, pause, resume or cancel one Hive broadcast. Scheduling and resuming start real messages going out to everyone in the audience, so your AI asks you first and, with Hive approvals on, Hive asks again inside Hive. For all broadcasts, discover set_broadcast_emergency_stop with list_workspace_operations.
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | What to do with it. | |
| broadcastId | Yes | The Hive broadcast to change. | |
| scheduledAt | No | When to send it, for the schedule action. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedReviewKey | No | Required for scheduling: the reviewKey from preflight_broadcast for the exact content, settings and audience definitions reviewed. Any change requires a new preflight and approval. |
set_contact_consentRecord Hive contact consentIdempotentInspect
Record that one person opted in, opted out or was suppressed for one purpose. Hive refuses to send where consent is not live, so this is what decides whether that person can be messaged again.
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Why, in the words a teammate would use. | |
| status | Yes | What was recorded. | |
| purpose | Yes | What the consent covers. | |
| contactId | Yes | The Hive contact identity. | |
| occurredAt | No | When it happened, as an ISO date. Defaults to now. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_enrollment_statusChange a Hive sequence enrollmentDestructiveIdempotentInspect
Pause, resume or cancel one person’s place in a Hive sequence.
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | What to do with this enrollment. | |
| sequenceId | Yes | The Hive sequence. | |
| enrollmentId | Yes | The enrollment to change. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_member_roleChange a teammate’s Hive roleDestructiveIdempotentInspect
Give one teammate a different Hive role, after a person approves this exact action in Hive. It cannot change the workspace owner, invite anyone, or remove anyone.
| Name | Required | Description | Default |
|---|---|---|---|
| roleId | Yes | The role from read_team_roles. | |
| memberId | Yes | The teammate from read_team. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
set_sequence_statusSet a Hive sequence statusDestructiveIdempotentInspect
Publish, pause, resume or archive one Hive sequence. Publishing locks the reviewed draft for later enrollment. Resuming allows remaining messages to eligible enrolled people. Your AI asks first and, with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | What to do with it. | |
| sequenceId | Yes | The Hive sequence to change. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The exact revision returned by read_sequence that the person reviewed. |
shuffle_queueShuffle the Hive queueIdempotentInspect
Reorder the unlocked future posts in the Hive queue among the times the queue already holds, so nothing moves to a new hour. Preview it first, then apply the exact plan you previewed.
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | The seed from the preview. Send it back with apply so the same order is applied. | |
| action | Yes | preview returns the plan and changes nothing; apply commits the plan you previewed. | |
| digest | No | The digest from the preview. Hive refuses apply if the queue changed since. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
start_flow_for_contactStart a Hive automation for a contactDestructiveIdempotentInspect
Start one live Hive automation for one person, in their latest conversation on their account. Hive refuses in plain words, and sends nothing, when the reply window has closed, the person has not opted in, the account needs reconnecting, or automations are paused for this person or their conversation. This sends real messages, so your AI asks before it runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The live automation to start. Automation ids come from read_automations. | |
| contactId | Yes | The Hive contact identity. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
suggest_replyDraft a reply for a Hive conversationIdempotentInspect
Ask Hive’s own AI for a suggested reply to one Hive Inbox conversation. It returns the draft and sends nothing: a person still has to send it in Hive. It uses the workspace’s AI allowance, which is why it counts as a write.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| providerConnectionId | No | An AI connection id. Leave it out to use the Hive-funded model. |
tag_threadTag a Hive conversationIdempotentInspect
Set the tags or the topic on one Hive Inbox conversation, or release them back to Hive’s own classification. It sends no message to the contact.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| tagIds | No | The workspace tag ids this conversation carries. Sending an empty list clears them. | |
| topicId | No | The workspace topic id. Send an empty string to clear it. | |
| threadId | Yes | The conversation id. | |
| releaseTags | No | Hand the tags back to Hive’s own classification. | |
| releaseTopic | No | Hand the topic back to Hive’s own classification. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
test_flowSafely test a Hive automationIdempotentInspect
Walk one saved Hive automation through a made-up conversation and return what each step would do. Nothing is sent, nobody is messaged and no contact is changed. It tests the DRAFT as saved; going live is still a separate step a person approves in Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to test. | |
| fixture | No | The made-up person and event to walk through: contact, event, workspace, channel and flow values. | |
| options | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
try_ai_replyTry a Hive AI replyIdempotentInspect
Draft one Hive AI answer to a test message and return it for review. Nothing is sent, no contact is changed, and no contact allowance is used.
| Name | Required | Description | Default |
|---|---|---|---|
| context | No | Anything else the AI should know. | |
| policyId | Yes | The Hive AI policy to try. | |
| customerText | Yes | The message to answer, at most 8,000 characters. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| providerConnectionId | No | Optional saved provider connection for this evaluation. |
unarchive_flowBring back an archived Hive automationIdempotentInspect
Bring one archived Hive automation back to the library. A previously published automation returns paused; an unpublished one returns as a draft. Going live is a separate action.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to bring back. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
unpublish_bio_pageTake the Hive Bio page downDestructiveIdempotentInspect
Take the Hive Bio page off the public web. Anyone who opens the address after this, including from a printed QR code, will not find the page. Your AI asks you before this runs; with Hive approvals on, Hive asks again inside Hive.
| Name | Required | Description | Default |
|---|---|---|---|
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedPublishedVersionId | Yes | The publishedVersionId from read_bio_page. Hive refuses if the public page changed after it was reviewed. |
update_advocacy_itemUpdate Hive advocacy contentIdempotentInspect
Change which advocacy groups a Hive advocacy item is aimed at. Its approval state is changed with set_advocacy_lifecycle.
| Name | Required | Description | Default |
|---|---|---|---|
| contentId | Yes | The advocacy item id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| targetGroupIds | Yes | Advocacy group ids this item is aimed at. |
update_ai_intentUpdate a Hive AI intentIdempotentInspect
Change one Hive AI intent.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| status | No | ||
| intentId | Yes | The intent to change. | |
| policyId | No | Assign a policy or clear the assignment with null. | |
| description | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| negativeExamples | No | ||
| positiveExamples | No | ||
| confidenceThreshold | No |
update_ai_knowledgeUpdate Hive AI knowledgeIdempotentInspect
Change one Hive AI knowledge source. Approving one is refused unless the person is an owner or admin.
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| status | No | ||
| markFresh | No | Record that the source was checked today. | |
| sourceUrl | No | Source URL, or an empty string to clear it. | |
| knowledgeId | Yes | The source to change. | |
| expectedTitle | No | Exact reviewed title. | |
| freshnessDays | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| approvedContent | No | ||
| expectedSourceUrl | No | Exact reviewed source URL; empty for no URL. | |
| expectedUpdatedAt | No | Exact updatedAt of the source whose complete wording was reviewed. | |
| expectedContentSha256 | No | For approval/review: exact contentSha256 from the complete read_ai_knowledge_sources native operation. Review its full wording first. | |
| expectedFreshnessDays | No | Exact reviewed freshnessDays. |
update_ai_policyUpdate a Hive AI policyIdempotentInspect
Change one Hive AI policy. Enabling one is refused unless the person is an owner or admin.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| tone | No | ||
| status | No | Native lifecycle status. The legacy disabled value is accepted as paused. | |
| policyId | Yes | The policy to change. | |
| goalEvent | No | Optional goal event, or null to clear it. | |
| languages | No | ||
| policyType | No | ||
| instruction | No | ||
| outputSchema | No | The policy output schema stored by Hive. | |
| piiRedaction | No | Redact personal information before evaluation. | |
| allowedTopics | No | ||
| blockedTopics | No | ||
| retentionDays | No | Stored result retention, from 0 to 3650 days. | |
| fallbackAction | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| injectionDefense | No | Enable the native injection checks. | |
| requireCitations | No | ||
| knowledgeSourceIds | No | Exact knowledge source ids to use; an empty list restores the native default. | |
| confidenceThreshold | No | ||
| providerConnectionId | No | Saved provider connection id, or null for the workspace default. | |
| requireHumanApproval | No |
update_approval_workflowChange a Hive approval workflowIdempotentInspect
Rewrite one Hive approval workflow, replacing its reviewers with the ones you supply. Posts already in review keep the reviewers they started with.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What this workflow is called. | |
| steps | Yes | The reviewers, in order. | |
| active | No | Whether this workflow can be used. | |
| isDefault | No | Use this workflow for every post submitted for approval. | |
| workflowId | Yes | The workflow id from read_approval_workflows. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_bio_blockChange a Hive Bio blockIdempotentInspect
Change one block on the Hive Bio page and save it as a draft. Hive allows one highlighted row per page, so highlighting this one clears the others; a block whose content is no longer finished is switched off rather than shown broken.
| Name | Required | Description | Default |
|---|---|---|---|
| patch | Yes | Only the fields that change, named as describe_bio_blocks says. | |
| blockId | Yes | The id read_bio_page gave for this block. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_bio_documentChange the complete Hive Bio draftIdempotentInspect
Replace the complete Hive Bio draft document returned by read_bio_page, including every header, design, profile, page setting and block field. Send the saved version you read so changes made in Hive are preserved. Hive validates the same document as its editor. This saves a draft and publishes nothing.
| Name | Required | Description | Default |
|---|---|---|---|
| document | Yes | The complete document from read_bio_page with the requested changes. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedDraftVersionId | Yes | The draftVersionId from read_bio_page, or publishedVersionId when no draft exists. |
update_broadcastUpdate a Hive broadcast draftIdempotentInspect
Change one Hive broadcast draft. A scheduled broadcast can no longer be edited, so Hive refuses that in plain words.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| document | No | ||
| timezone | No | ||
| segmentId | No | ||
| quietHours | No | ||
| broadcastId | Yes | The Hive broadcast to change. | |
| frequencyCap | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_broadcast returned for the draft. | |
| exclusionSegmentIds | No |
update_campaignUpdate a Hive campaignIdempotentInspect
Change a Hive campaign: its name, colour, goal or the accounts it covers. Posts already in it stay in it.
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | ||
| name | No | ||
| color | No | ||
| campaignId | Yes | The campaign id. | |
| channelIds | No | Hive channel ids this campaign covers. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_channel_settingsUpdate Hive channel settingsIdempotentInspect
Change one connected account’s Hive posting schedule or general settings: its time zone, its slot times, the days it posts and its weekly goal. Performance-based times are set in Hive itself, because they are saved from verified post history.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| slots | No | ||
| timezone | No | IANA time zone for this account’s queue. | |
| channelId | Yes | The Hive channel id. | |
| goalPerWeek | No | How many posts a week this account aims for. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_contactSave Hive contact fieldsIdempotentInspect
Save one or many stored field values on one Hive contact, by field id or by name. Send one field and its value, or fields for up to 20 at once. Every value is checked before any is saved; retrying the same request finishes a partly saved batch without saving anything twice.
| Name | Required | Description | Default |
|---|---|---|---|
| value | No | The value to store in the field. | |
| fields | No | Up to 20 fields to set in one call, instead of one field and value. | |
| fieldId | No | The contact field to set. | |
| verified | No | Mark this value as verified. | |
| contactId | Yes | The Hive contact identity. | |
| fieldName | No | The field’s key or name, instead of fieldId. | |
| updatePolicy | No | What to do when a value is already stored. Defaults to replace_unverified. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_default_replyUpdate a Hive default replyIdempotentInspect
Change one Hive DM automation default reply. Fields you leave out keep the value they already have.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| status | No | ||
| keywords | No | ||
| timezone | No | ||
| accountIds | No | ||
| keywordMode | No | ||
| savedReplyId | No | ||
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| businessHours | No | ||
| defaultReplyId | Yes | The default reply to change. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| cooldownMinutes | No | ||
| firstContactOnly | No | ||
| handoffAfterSend | No | ||
| businessHoursMode | No | ||
| maxSendsPerThread | No |
update_draftUpdate a Hive post draftIdempotentInspect
Change an existing Hive draft: its words, hashtags, media, accounts, per-network options, campaigns or tags. This never publishes and never messages anyone.
| Name | Required | Description | Default |
|---|---|---|---|
| cover | No | The composer cover plan. Omit to keep the existing cover; null removes it. | |
| media | No | The photos and videos on the post, in order. | |
| title | No | Shared title. Mainly YouTube. | |
| postId | Yes | The Hive draft to change. | |
| tagIds | No | Internal tag ids. | |
| caption | No | Shared caption. | |
| privacy | No | Shared privacy, overridden by per-network options when supplied. | |
| hashtags | No | Hashtags appended per network rules. | |
| tagNames | No | Internal tag names. Unknown names are refused with the list of tags that exist. | |
| assigneeId | No | The teammate asked to approve this post. | |
| channelIds | No | The connected Hive accounts this post goes to. | |
| campaignIds | No | Campaign ids. | |
| perPlatform | No | Per-network options keyed by network (instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest, snapchat, bluesky, mastodon, whatsapp, telegram). Each value takes what Hive's composer takes, for example postType (post, reel, story), caption, title, privacy, firstComment, igLocationId, igAltText, igCollaborators, coverUrl, threadsReplyControl, youtubeFormat, tiktokPrivacyLevel. Anything omitted falls back to the shared values. | |
| firstComment | No | A first comment posted under the post where the network supports it. | |
| linkTracking | No | Whether Hive rewrites links for click tracking. Defaults to the workspace setting. | |
| campaignNames | No | Campaign names. Unknown names are refused with the list of campaigns that exist. | |
| hashtagGroupId | No | A saved hashtag group. Its hashtags are merged with any you pass. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| approvalWorkflowId | No | The approval workflow to run instead of the workspace default. |
update_entry_pointUpdate a Hive automation entry pointIdempotentInspect
Change one Hive entry point’s name, settings or status. Pausing it deadens every printed code and shared link immediately.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| name | No | ||
| slug | No | ||
| config | No | ||
| flowId | No | ||
| status | No | Disabled stops shared links and printed codes; paused is a legacy alias for disabled. | |
| accountId | No | ||
| entryPointId | Yes | The entry point to change. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_entry_points returned. |
update_flow_documentReplace a Hive automation documentIdempotentInspect
Replace the whole document of one Hive automation and save it as a DRAFT. Send the revision and draftVersionId you read, so a change somebody else made in Hive is never overwritten. Hive refuses and saves nothing when the new document has anything wrong with it. Going live stays a separate step a person approves.
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | Yes | The Hive automation to change. | |
| document | Yes | The whole new document. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_flow_document returned. | |
| expectedDraftVersionId | Yes | The draftVersionId read_flow_document returned. |
update_keyword_ruleUpdate a Hive automation ruleIdempotentInspect
Change one Hive automation rule, or move it between draft, active and paused. Send the action to change its status, or the name and document to change what it does.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| action | No | Activate starts this rule running on real events. Leave it out to edit the rule instead. | |
| ruleId | Yes | The Hive rule to change. | |
| document | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_keyword_rules returned for this rule. |
update_listening_queryUpdate a Hive listening searchIdempotentInspect
Rename a saved Hive listening search or change the window it reports on.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| queryId | Yes | The saved search id. | |
| windowDays | No | 7 or 30. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_planning_cardUpdate a Hive planning cardIdempotentInspect
Change one card on a Hive planning board: its words, its status or its notes. Pass the expectedVersion you read, so a change someone else made at the same time is never overwritten.
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| title | No | ||
| cardId | Yes | The card id. | |
| status | No | ||
| boardId | Yes | The board id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedVersion | Yes | The version read_planning_board returned. |
update_reportUpdate a Hive reportIdempotentInspect
Change a saved Hive report: its title, description, date period, channels or widgets. This never sends or shares anything.
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| widgets | No | The full widget list, as read_report returns it. | |
| branding | No | Hive report colors and header/footer notes. Use upload_report_logo to change the logo. | |
| coverUrl | No | Hive report cover image URL; null removes the cover. | |
| reportId | Yes | The Hive report id. | |
| channelIds | No | Hive channel ids this report covers. | |
| datePeriod | No | ||
| description | No | ||
| internalNotes | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_saved_replyChange a Hive saved replyIdempotentInspect
Change the title or the words of one Hive saved reply. This is an internal template, so nothing is sent to anyone.
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | The new words. | |
| title | No | The new title. | |
| savedReplyId | Yes | The saved reply id from read_saved_replies. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_segmentUpdate a Hive contact segmentIdempotentInspect
Change one Hive contact segment’s name, description or filter. Anything already scheduled against it will use the new filter.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| filter | No | ||
| segmentId | Yes | The segment to change. | |
| description | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_sequenceUpdate a Hive sequenceIdempotentInspect
Change one Hive sequence draft. Publishing is a separate step, so this never starts anything sending.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| document | No | ||
| sequenceId | Yes | The Hive sequence to change. | |
| description | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| expectedRevision | Yes | The revision read_sequence returned. |
update_simple_automationUpdate a Hive simple automation draftIdempotentInspect
Rewrite an existing Hive simple automation and return it as a DRAFT: going live needs the person to open the approval link in Hive. Change the words, the link, the account, the posts it watches or the extra steps. It sends nothing.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional new name. | |
| flowId | Yes | The Hive automation to change. | |
| recipe | Yes | Which Hive simple automation this is. | |
| linkUrl | No | The destination the link message opens. | |
| options | No | ||
| postIds | No | External post ids from read_eligible_posts (or story ids from read_eligible_stories) this automation watches. At most 20. Leave empty to watch every post on the account. | |
| keywords | No | The words a comment or message must contain. | |
| platform | No | The network when accountId is not known yet: instagram, facebook, whatsapp, tiktok, messenger. Hive answers with the accounts to choose from instead of guessing. | |
| accountId | No | The connected Hive account this automation runs on. Leave it out to get the list of accounts to choose from; never guess it. | |
| postScope | No | any watches every post on the account; specific watches only postIds. | |
| replyText | No | The message the automation sends. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. | |
| linkButtonLabel | No | The label on the button people tap to ask for the link. | |
| publicReplyText | No | A public reply to the comment. Supplying it switches the public reply step on. |
update_tagUpdate a Hive tagIdempotentInspect
Rename a Hive content tag or change its colour. Posts keep the tag.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| color | No | A hex colour such as #8B7CF6. | |
| tagId | Yes | The tag id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
update_thread_noteChange a private note on a Hive conversationIdempotentInspect
Rewrite an internal note you can edit on one Hive Inbox conversation. Nothing reaches the contact.
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The new note, 1 to 4000 characters. | |
| kind | Yes | Which kind of conversation this is: dm, comment or mention. | |
| noteId | Yes | The note id from read_thread_notes. | |
| threadId | Yes | The conversation id. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
upload_media_from_urlImport a photo or video into HiveIdempotentInspect
Import one attached photo or video, or a public media URL, into this workspace’s Hive Asset Library so a post can use it. Supply exactly one of file or url. This publishes nothing. Private network addresses, insecure redirects, files over 100 MB and unsupported types are refused.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The public link to the photo or video. | |
| file | No | ||
| title | No | A name for the Asset Library item. | |
| altText | No | Accessibility text saved with the item. | |
| folderId | No | An Asset Library folder to file it in. | |
| channelGroupId | No | An accessible channel group from read_media_library. Required when the library saves assets per group. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
validate_postCheck a Hive post against its networksRead-onlyIdempotentInspect
Check a Hive post against every network it targets and list what each one would refuse, before anything is written. It reads only: it changes nothing and sends nothing.
| Name | Required | Description | Default |
|---|---|---|---|
| media | No | The photos and videos on the post, in order. | |
| title | No | ||
| postId | No | An existing Hive post to check. Leave it out and pass the fields instead. | |
| caption | No | ||
| hashtags | No | ||
| channelIds | No | The connected Hive accounts to check against. | |
| perPlatform | No | Per-network options keyed by network (instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest, snapchat, bluesky, mastodon, whatsapp, telegram). Each value takes what Hive's composer takes, for example postType (post, reel, story), caption, title, privacy, firstComment, igLocationId, igAltText, igCollaborators, coverUrl, threadsReplyControl, youtubeFormat, tiktokPrivacyLevel. Anything omitted falls back to the shared values. |
write_workspace_operationUse another Hive controlDestructiveIdempotentInspect
Change a Hive operation found by list_workspace_operations. Your AI asks before this runs; with Hive approvals on, Hive asks again inside Hive. Uses the connected person and workspace and also needs the operation’s own write scope. Requires an OAuth connection.
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Only the editable fields listed for this operation. Hive checks the same rules as its screen. | |
| file | No | Attached file for operations advertising a remote file or image upload. Supply either this file or the operation’s image URL, never both. | |
| path | No | The named record ids required by this operation. | |
| query | No | Only the query fields listed for this operation. | |
| operation | Yes | An exact operation id returned by list_workspace_operations. | |
| approvalToken | No | Single-use token returned by Hive after the owner approves this exact action. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
9 tool updates
- Added
add_contact_tag - Added
create_contact - Changed
create_flow1 field changed- changed
Input schema / properties / triggerEvent / enumPrevious value: -[ - "comment", - "keyword", - "inbound_message", - "story_reply", - "story_mention", - "post_share", - "live_comment", - "referral_link" -]New value: +[ + "comment", + "keyword", + "inbound_message", + "story_reply", + "story_mention", + "post_share", + "dm_post_share", + "live_comment", + "referral_link" +]
- Added
read_bot_fields - Changed
read_contacts5 fields changed- added
Input schema / properties / emailAdded value: +{ + "description": "Find people by exact email address. Use only one of email, phone or fieldId.", + "type": "string" +} - added
Input schema / properties / fieldIdAdded value: +{ + "description": "Find people whose contact field has exactly fieldValue. Field ids come from read_contact_fields.", + "type": "string" +} - added
Input schema / properties / fieldNameAdded value: +{ + "description": "The field’s key or name, instead of fieldId.", + "type": "string" +} - added
Input schema / properties / fieldValueAdded value: +{ + "description": "The value to match in fieldId.", + "type": [ + "string", + "number", + "boolean" + ] +} - added
Input schema / properties / phoneAdded value: +{ + "description": "Find people by exact phone number in international format, like +14155550123.", + "type": "string" +}
- Added
remove_contact_tag - Added
set_bot_fields - Added
start_flow_for_contact - Changed
update_contact5 fields changed- added
Input schema / properties / fieldNameAdded value: +{ + "description": "The field’s key or name, instead of fieldId.", + "type": "string" +} - added
Input schema / properties / fieldsAdded value: +{ + "description": "Up to 20 fields to set in one call, instead of one field and value.", + "items": { + "properties": { + "fieldId": { + "description": "The contact field to set.", + "type": "string" + }, + "fieldName": { + "description": "The field’s key or name, instead of fieldId.", + "type": "string" + }, + "value": { + "description": "The value to store.", + "type": [ + "string", + "number", + "boolean", + "array" + ] + } + }, + "required": [ + "value" + ], + "type": "object" + }, + "type": "array" +} - changed
Input schema / properties / value / descriptionPrevious value: -"The value to store."New value: +"The value to store in the field." - changed
Input schema / properties / value / typePrevious value: -"string"New value: +[ + "string", + "number", + "boolean", + "array" +] - changed
Input schema / requiredPrevious value: -[ - "contactId", - "fieldId", - "idempotencyKey" -]New value: +[ + "contactId", + "idempotencyKey" +]
5 tool updates
- Changed
approve_post3 fields changed- added
Input schema / properties / reviewRunIdAdded value: +{ + "description": "Exact reviewRunId from read_pending_approvals, including null for a single reviewer.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / reviewStepIdAdded value: +{ + "description": "Exact reviewStepId from read_pending_approvals, including null for a single reviewer.", + "type": [ + "string", + "null" + ] +} - changed
Input schema / requiredPrevious value: -[ - "postId", - "reviewFingerprint", - "idempotencyKey" -]New value: +[ + "postId", + "reviewFingerprint", + "reviewRunId", + "reviewStepId", + "idempotencyKey" +]
- Changed
reject_post3 fields changed- added
Input schema / properties / reviewRunIdAdded value: +{ + "description": "Exact reviewRunId from read_pending_approvals, including null for a single reviewer.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / reviewStepIdAdded value: +{ + "description": "Exact reviewStepId from read_pending_approvals, including null for a single reviewer.", + "type": [ + "string", + "null" + ] +} - changed
Input schema / requiredPrevious value: -[ - "postId", - "reviewFingerprint", - "reason", - "idempotencyKey" -]New value: +[ + "postId", + "reviewFingerprint", + "reviewRunId", + "reviewStepId", + "reason", + "idempotencyKey" +]
- Changed
request_changes_on_post3 fields changed- added
Input schema / properties / reviewRunIdAdded value: +{ + "description": "Exact reviewRunId from read_pending_approvals, including null for a single reviewer.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / reviewStepIdAdded value: +{ + "description": "Exact reviewStepId from read_pending_approvals, including null for a single reviewer.", + "type": [ + "string", + "null" + ] +} - changed
Input schema / requiredPrevious value: -[ - "postId", - "reviewFingerprint", - "note", - "idempotencyKey" -]New value: +[ + "postId", + "reviewFingerprint", + "reviewRunId", + "reviewStepId", + "note", + "idempotencyKey" +]
- Changed
schedule_post1 field changed- added
Input schema / properties / expectedVersionAdded value: +{ + "description": "Required with postId: the exact version returned by read_post for the content being approved. Changed content requires a fresh review.", + "type": "string" +}
- Changed
update_ai_knowledge5 fields changed- added
Input schema / properties / expectedContentSha256Added value: +{ + "description": "For approval/review: exact contentSha256 from the complete read_ai_knowledge_sources native operation. Review its full wording first.", + "type": "string" +} - added
Input schema / properties / expectedFreshnessDaysAdded value: +{ + "description": "Exact reviewed freshnessDays.", + "type": "integer" +} - added
Input schema / properties / expectedSourceUrlAdded value: +{ + "description": "Exact reviewed source URL; empty for no URL.", + "type": "string" +} - added
Input schema / properties / expectedTitleAdded value: +{ + "description": "Exact reviewed title.", + "type": "string" +} - added
Input schema / properties / expectedUpdatedAtAdded value: +{ + "description": "Exact updatedAt of the source whose complete wording was reviewed.", + "type": "string" +}
57 tool updates
- Changed
add_bio_block1 field changed- changed
Input schema / properties / type / enumPrevious value: -[ - "link", - "text", - "heading", - "image", - "gallery", - "video", - "music", - "social", - "email-signup", - "contact-form", - "poll", - "pdf", - "map", - "contact-details", - "email", - "stats", - "faq", - "event", - "discount", - "destination", - "product", - "booking", - "course", - "community", - "collection" -]New value: +[ + "link", + "text", + "heading", + "image", + "gallery", + "video", + "music", + "social", + "email-signup", + "contact-form", + "poll", + "pdf", + "map", + "contact-details", + "email", + "stats", + "faq", + "event", + "discount", + "destination", + "product", + "booking", + "course", + "community", + "collection", + "chatbot", + "message-me" +]
- Changed
add_competitor1 field changed- added
Input schema / properties / approvalTokenAdded value: +{ + "type": "string" +}
- Added
admin_workspace_operation - Changed
assign_review7 fields changed- changed
Input schema / properties / assigneeId / descriptionPrevious value: -"The Hive member id, or leave it out to unassign."New value: +"The current Hive member id, or null to unassign." - changed
Input schema / properties / assigneeId / typePrevious value: -"string"New value: +[ + "string", + "null" +] - changed
Input schema / properties / channelId / descriptionPrevious value: -"The Hive channel this review belongs to."New value: +"The existing accessible Hive channel, or null to clear it." - changed
Input schema / properties / channelId / typePrevious value: -"string"New value: +[ + "string", + "null" +] - added
Input schema / properties / labelIdsAdded value: +{ + "description": "The full intended label list; copy existing labels from read_review to preserve them.", + "items": { + "type": "string" + }, + "type": "array" +} - changed
Input schema / properties / status / descriptionPrevious value: -"The workflow status. Defaults to open."New value: +"The intended workflow status." - changed
Input schema / requiredPrevious value: -[ - "reviewName", - "idempotencyKey" -]New value: +[ + "reviewName", + "assigneeId", + "status", + "channelId", + "labelIds", + "idempotencyKey" +]
- Changed
create_ai_intent4 fields changed- changed
Input schema / properties / confidenceThreshold / descriptionPrevious value: -"How sure the AI must be, from 0 to 1."New value: +"Minimum intent confidence, from 0.5 to 1." - added
Input schema / properties / confidenceThreshold / maximumAdded value: +1 - added
Input schema / properties / confidenceThreshold / minimumAdded value: +0.5 - changed
Input schema / requiredPrevious value: -[ - "name", - "idempotencyKey" -]New value: +[ + "name", + "positiveExamples", + "idempotencyKey" +]
- Changed
create_ai_policy8 fields changed- added
Input schema / properties / goalEventAdded value: +{ + "description": "Optional goal event, or null to clear it.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / injectionDefenseAdded value: +{ + "description": "Enable the native injection checks.", + "type": "boolean" +} - added
Input schema / properties / knowledgeSourceIdsAdded value: +{ + "description": "Exact knowledge source ids to use; an empty list restores the native default.", + "items": { + "type": "string" + }, + "type": "array" +} - added
Input schema / properties / outputSchemaAdded value: +{ + "additionalProperties": true, + "description": "The policy output schema stored by Hive.", + "type": "object" +} - added
Input schema / properties / piiRedactionAdded value: +{ + "description": "Redact personal information before evaluation.", + "type": "boolean" +} - added
Input schema / properties / providerConnectionIdAdded value: +{ + "description": "Saved provider connection id, or null for the workspace default.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / retentionDaysAdded value: +{ + "description": "Stored result retention, from 0 to 3650 days.", + "type": "integer" +} - changed
Input schema / requiredPrevious value: -[ - "name", - "idempotencyKey" -]New value: +[ + "name", + "policyType", + "idempotencyKey" +]
- Changed
create_approval_workflow1 field changed- added
Input schema / properties / activeAdded value: +{ + "description": "Whether this workflow can be used.", + "type": "boolean" +}
- Added
create_bio_page - Changed
create_bio_short_link10 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / campaignIdAdded value: +{ + "description": "An existing campaign in this workspace; its tracking defaults are merged.", + "type": "string" +} - added
Input schema / properties / domainAdded value: +{ + "description": "An active branded domain owned by this workspace; otherwise use its Hive default.", + "type": "string" +} - added
Input schema / properties / expiresAtAdded value: +{ + "description": "Optional expiry time in ISO format.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / platformAdded value: +{ + "description": "Optional social network attribution.", + "type": "string" +} - added
Input schema / properties / routingRulesAdded value: +{ + "items": { + "properties": { + "action": { + "enum": [ + "route", + "block", + "alternate" + ], + "type": "string" + }, + "alternateUrl": { + "type": "string" + }, + "enabled": { + "type": "boolean" + }, + "id": { + "type": "string" + }, + "kind": { + "enum": [ + "country", + "referrer-platform", + "device" + ], + "type": "string" + }, + "operator": { + "enum": [ + "is", + "is-not", + "in" + ], + "type": "string" + }, + "value": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + } + }, + "type": "object" + }, + "maxItems": 10, + "type": "array" +} - added
Input schema / properties / socialPostIdAdded value: +{ + "description": "An existing post you can access in this workspace.", + "type": "string" +} - added
Input schema / properties / startsAtAdded value: +{ + "description": "Optional start time in ISO format.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / tagsAdded value: +{ + "items": { + "type": "string" + }, + "maxItems": 10, + "type": "array" +} - added
Input schema / properties / utmAdded value: +{ + "properties": { + "utm_campaign": { + "type": "string" + }, + "utm_content": { + "type": "string" + }, + "utm_medium": { + "type": "string" + }, + "utm_source": { + "type": "string" + }, + "utm_term": { + "type": "string" + } + }, + "type": "object" +}
- Changed
create_default_reply6 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / businessHours / properties / daysAdded value: +{ + "description": "Weekdays: Sunday is 0 and Saturday is 6.", + "items": { + "maximum": 6, + "minimum": 0, + "type": "integer" + }, + "minItems": 1, + "type": "array" +} - added
Input schema / properties / businessHours / properties / endAdded value: +{ + "description": "Closing time in HH:MM, in the rule timezone.", + "type": "string" +} - added
Input schema / properties / businessHours / properties / startAdded value: +{ + "description": "Opening time in HH:MM, in the rule timezone.", + "type": "string" +} - changed
Input schema / properties / status / descriptionPrevious value: -"Active starts answering real people on the next message."New value: +"Active starts answering real people on the next message. Paused stops replies; draft is a legacy alias for paused." - changed
Input schema / properties / status / enumPrevious value: -[ - "draft", - "active" -]New value: +[ + "paused", + "active", + "draft" +]
- Changed
create_draft2 fields changed- added
Input schema / properties / coverAdded value: +{ + "additionalProperties": true, + "description": "The composer cover plan. Omit to keep the existing cover; null removes it.", + "type": [ + "object", + "null" + ] +} - added
Input schema / properties / privacyAdded value: +{ + "description": "Shared privacy, overridden by per-network options when supplied.", + "enum": [ + "public", + "private", + "unlisted" + ], + "type": "string" +}
- Changed
create_entry_point12 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / config / properties / accessibleLabelAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / properties / allowedDomainsAdded value: +{ + "description": "Website button domains; an empty list allows no websites.", + "items": { + "type": "string" + }, + "type": "array" +} - added
Input schema / properties / config / properties / campaignAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / properties / labelAdded value: +{ + "description": "Required visible link, button or QR label.", + "type": "string" +} - added
Input schema / properties / config / properties / mediumAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / properties / qrAdded value: +{ + "properties": { + "backgroundColor": { + "description": "Six-digit hex color.", + "type": "string" + }, + "foregroundColor": { + "description": "Six-digit hex color.", + "type": "string" + }, + "logoDataUrl": { + "description": "Optional PNG, JPEG or WebP data URL, at most 256 KB.", + "type": "string" + }, + "removeLogoBackground": { + "type": "boolean" + }, + "size": { + "description": "100–2000 pixels.", + "type": "integer" + } + }, + "type": "object" +} - added
Input schema / properties / config / properties / sourceAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / requiredAdded value: +[ + "label" +] - added
Input schema / properties / slugAdded value: +{ + "description": "Required unique slug: 1–64 lowercase letters, numbers or single hyphens.", + "type": "string" +} - added
Input schema / properties / statusAdded value: +{ + "description": "Defaults to draft.", + "enum": [ + "draft", + "active", + "disabled" + ], + "type": "string" +} - changed
Input schema / requiredPrevious value: -[ - "flowId", - "kind", - "name", - "idempotencyKey" -]New value: +[ + "flowId", + "accountId", + "kind", + "name", + "slug", + "config", + "idempotencyKey" +]
- Changed
create_listening_alert3 fields changed- added
Input schema / properties / queryAdded value: +{ + "description": "The exact saved search text, resolved after native normalization when queryId is absent.", + "type": "string" +} - changed
Input schema / properties / queryId / descriptionPrevious value: -"The saved search id."New value: +"The saved search id; alternatively provide its query text." - changed
Input schema / requiredPrevious value: -[ - "queryId", - "idempotencyKey" -]New value: +[ + "idempotencyKey" +]
- Changed
create_messenger_menu6 fields changed- added
Input schema / properties / items / descriptionAdded value: +"Top-level Flow or HTTPS website actions. Saving pins the current published Messenger Flow version for this exact Facebook Page." - added
Input schema / properties / items / itemsAdded value: +{ + "properties": { + "flowId": { + "description": "Published Flow id for a flow action.", + "type": "string" + }, + "id": { + "description": "Stable local item id.", + "type": "string" + }, + "label": { + "description": "Visible action text.", + "type": "string" + }, + "type": { + "enum": [ + "flow", + "website" + ], + "type": "string" + }, + "url": { + "description": "HTTPS URL for a website action.", + "type": "string" + } + }, + "required": [ + "id", + "label", + "type" + ], + "type": "object" +} - added
Input schema / properties / items / maxItemsAdded value: +20 - added
Input schema / properties / items / minItemsAdded value: +1 - removed
Input schema / properties / items / propertiesRemoved value: -{} - changed
Input schema / properties / items / typePrevious value: -"object"New value: +"array"
- Removed
create_podcast_episode - Removed
create_podcast_show - Changed
create_recurring_post3 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / coverAdded value: +{ + "additionalProperties": true, + "description": "The composer cover plan. Omit to keep the existing cover; null removes it.", + "type": [ + "object", + "null" + ] +} - added
Input schema / properties / privacyAdded value: +{ + "description": "Shared privacy, overridden by per-network options when supplied.", + "enum": [ + "public", + "private", + "unlisted" + ], + "type": "string" +}
- Changed
delete_default_reply1 field changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +}
- Removed
delete_podcast_episode - Removed
delete_podcast_show - Changed
enroll_contact_in_sequence2 fields changed- added
Input schema / properties / expectedVersionAdded value: +{ + "description": "The positive currentVersion from read_sequence whose publishedDocument the person reviewed.", + "type": "integer" +} - changed
Input schema / requiredPrevious value: -[ - "sequenceId", - "contactId", - "entryEventKey", - "idempotencyKey" -]New value: +[ + "sequenceId", + "expectedVersion", + "contactId", + "entryEventKey", + "idempotencyKey" +]
- Changed
label_review4 fields changed- added
Input schema / properties / assigneeIdAdded value: +{ + "description": "The existing member id, or null to unassign.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / channelIdAdded value: +{ + "description": "The existing accessible Hive channel, or null to clear it.", + "type": [ + "string", + "null" + ] +} - changed
Input schema / properties / status / descriptionPrevious value: -"The workflow status to keep. Defaults to open."New value: +"The intended workflow status." - changed
Input schema / requiredPrevious value: -[ - "reviewName", - "labelIds", - "idempotencyKey" -]New value: +[ + "reviewName", + "assigneeId", + "status", + "channelId", + "labelIds", + "idempotencyKey" +]
- Changed
list_automation_recipes1 field changed- added
Input schema / properties / recipeIdAdded value: +{ + "description": "Optional recipe id from this catalog to read one complete canvas template.", + "type": "string" +}
- Added
list_workspace_operations - Changed
publish_bio_page2 fields changed- added
Input schema / properties / expectedDraftVersionIdAdded value: +{ + "description": "The draftVersionId from read_bio_page, or publishedVersionId when no draft exists. The exact reviewed version is published.", + "type": "string" +} - changed
Input schema / requiredPrevious value: -[ - "idempotencyKey" -]New value: +[ + "expectedDraftVersionId", + "idempotencyKey" +]
- Changed
queue_competitor_refresh2 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "type": "string" +} - changed
Input schema / properties / competitorIds / descriptionPrevious value: -"Optional competitor IDs; omit to refresh all tracked competitors."New value: +"Optional competitor IDs; omit to select all currently tracked competitors. An empty list selects none."
- Changed
read_approval_workflows1 field changed- added
Input schema / properties / includeReviewerDetailsAdded value: +{ + "description": "Include external reviewer names and email addresses under the workspace private-text sharing and masking settings.", + "type": "boolean" +}
- Changed
read_bio_insights2 fields changed- added
Input schema / properties / dashboardAdded value: +{ + "description": "Use 1 for the lighter native dashboard report.", + "enum": [ + "0", + "1" + ], + "type": "string" +} - added
Input schema / properties / sampleAdded value: +{ + "description": "Use 1 only for labelled sample data.", + "enum": [ + "0", + "1" + ], + "type": "string" +}
- Changed
read_bio_short_links2 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"How many to return, 1 to 200. Defaults to 50."New value: +"Optional window size, 1 to 200. Omit for the complete list." - added
Input schema / properties / offsetAdded value: +{ + "description": "Optional starting offset; use nextOffset from the previous result.", + "type": "integer" +}
- Removed
read_podcast_episodes - Removed
read_podcasts - Changed
read_saved_replies1 field changed- added
Input schema / properties / queryAdded value: +{ + "description": "Optional text to match in saved reply titles or bodies.", + "type": "string" +}
- Added
read_workspace_operation - Added
read_workspace_result - Changed
remove_competitor1 field changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +}
- Changed
reply_to_comment3 fields changed- added
Input schema / properties / careReleaseAdded value: +{ + "properties": { + "approvalId": { + "type": "string" + }, + "releaseId": { + "type": "string" + }, + "versionHash": { + "type": "string" + } + }, + "required": [ + "releaseId", + "approvalId", + "versionHash" + ], + "type": "object" +} - added
Input schema / properties / clientRequestIdAdded value: +{ + "type": "string" +} - added
Input schema / properties / expectedVersionAdded value: +{ + "type": "integer" +}
- Changed
request_post_approval2 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / workflowIdAdded value: +{ + "description": "The selected approval workflow; omitted uses the workspace default.", + "type": "string" +}
- Changed
restore_deleted_post1 field changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +}
- Changed
schedule_post2 fields changed- added
Input schema / properties / coverAdded value: +{ + "additionalProperties": true, + "description": "The composer cover plan. Omit to keep the existing cover; null removes it.", + "type": [ + "object", + "null" + ] +} - added
Input schema / properties / privacyAdded value: +{ + "description": "Shared privacy, overridden by per-network options when supplied.", + "enum": [ + "public", + "private", + "unlisted" + ], + "type": "string" +}
- Changed
set_automation_live2 fields changed- added
Input schema / properties / expectedRevisionAdded value: +{ + "description": "The revision returned with the draftVersionId you reviewed. Edits to the same saved draft change this revision.", + "minimum": 1, + "type": "integer" +} - changed
Input schema / requiredPrevious value: -[ - "flowId", - "idempotencyKey" -]New value: +[ + "flowId", + "expectedVersionId", + "expectedRevision", + "idempotencyKey" +]
- Changed
set_broadcast_status1 field changed- added
Input schema / properties / expectedReviewKeyAdded value: +{ + "description": "Required for scheduling: the reviewKey from preflight_broadcast for the exact content, settings and audience definitions reviewed. Any change requires a new preflight and approval.", + "type": "string" +}
- Changed
set_sequence_status2 fields changed- added
Input schema / properties / expectedRevisionAdded value: +{ + "description": "The exact revision returned by read_sequence that the person reviewed.", + "type": "integer" +} - changed
Input schema / requiredPrevious value: -[ - "sequenceId", - "action", - "idempotencyKey" -]New value: +[ + "sequenceId", + "expectedRevision", + "action", + "idempotencyKey" +]
- Changed
try_ai_reply1 field changed- added
Input schema / properties / providerConnectionIdAdded value: +{ + "description": "Optional saved provider connection for this evaluation.", + "type": "string" +}
- Changed
unpublish_bio_page2 fields changed- added
Input schema / properties / expectedPublishedVersionIdAdded value: +{ + "description": "The publishedVersionId from read_bio_page. Hive refuses if the public page changed after it was reviewed.", + "type": "string" +} - changed
Input schema / requiredPrevious value: -[ - "idempotencyKey" -]New value: +[ + "expectedPublishedVersionId", + "idempotencyKey" +]
- Changed
update_ai_intent3 fields changed- added
Input schema / properties / confidenceThreshold / maximumAdded value: +1 - added
Input schema / properties / confidenceThreshold / minimumAdded value: +0.5 - added
Input schema / properties / policyIdAdded value: +{ + "description": "Assign a policy or clear the assignment with null.", + "type": [ + "string", + "null" + ] +}
- Changed
update_ai_knowledge3 fields changed- added
Input schema / properties / markFreshAdded value: +{ + "description": "Record that the source was checked today.", + "type": "boolean" +} - removed
Input schema / properties / scopeRemoved value: -{ - "enum": [ - "workspace", - "flow", - "inbox" - ], - "type": "string" -} - added
Input schema / properties / sourceUrlAdded value: +{ + "description": "Source URL, or an empty string to clear it.", + "type": "string" +}
- Changed
update_ai_policy10 fields changed- added
Input schema / properties / goalEventAdded value: +{ + "description": "Optional goal event, or null to clear it.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / injectionDefenseAdded value: +{ + "description": "Enable the native injection checks.", + "type": "boolean" +} - added
Input schema / properties / knowledgeSourceIdsAdded value: +{ + "description": "Exact knowledge source ids to use; an empty list restores the native default.", + "items": { + "type": "string" + }, + "type": "array" +} - added
Input schema / properties / outputSchemaAdded value: +{ + "additionalProperties": true, + "description": "The policy output schema stored by Hive.", + "type": "object" +} - added
Input schema / properties / piiRedactionAdded value: +{ + "description": "Redact personal information before evaluation.", + "type": "boolean" +} - added
Input schema / properties / policyTypeAdded value: +{ + "type": "string" +} - added
Input schema / properties / providerConnectionIdAdded value: +{ + "description": "Saved provider connection id, or null for the workspace default.", + "type": [ + "string", + "null" + ] +} - added
Input schema / properties / retentionDaysAdded value: +{ + "description": "Stored result retention, from 0 to 3650 days.", + "type": "integer" +} - added
Input schema / properties / status / descriptionAdded value: +"Native lifecycle status. The legacy disabled value is accepted as paused." - changed
Input schema / properties / status / enumPrevious value: -[ - "draft", - "enabled", - "disabled" -]New value: +[ + "draft", + "enabled", + "paused", + "archived", + "disabled" +]
- Added
update_bio_document - Changed
update_default_reply5 fields changed- added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / businessHours / properties / daysAdded value: +{ + "description": "Weekdays: Sunday is 0 and Saturday is 6.", + "items": { + "maximum": 6, + "minimum": 0, + "type": "integer" + }, + "minItems": 1, + "type": "array" +} - added
Input schema / properties / businessHours / properties / endAdded value: +{ + "description": "Closing time in HH:MM, in the rule timezone.", + "type": "string" +} - added
Input schema / properties / businessHours / properties / startAdded value: +{ + "description": "Opening time in HH:MM, in the rule timezone.", + "type": "string" +} - changed
Input schema / properties / status / enumPrevious value: -[ - "draft", - "active" -]New value: +[ + "paused", + "active", + "draft" +]
- Changed
update_draft2 fields changed- added
Input schema / properties / coverAdded value: +{ + "additionalProperties": true, + "description": "The composer cover plan. Omit to keep the existing cover; null removes it.", + "type": [ + "object", + "null" + ] +} - added
Input schema / properties / privacyAdded value: +{ + "description": "Shared privacy, overridden by per-network options when supplied.", + "enum": [ + "public", + "private", + "unlisted" + ], + "type": "string" +}
- Changed
update_entry_point15 fields changed- added
Input schema / properties / accountIdAdded value: +{ + "type": "string" +} - added
Input schema / properties / approvalTokenAdded value: +{ + "description": "Single-use token returned by Hive after the owner approves this exact action.", + "type": "string" +} - added
Input schema / properties / config / properties / accessibleLabelAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / properties / allowedDomainsAdded value: +{ + "description": "Website button domains; an empty list allows no websites.", + "items": { + "type": "string" + }, + "type": "array" +} - added
Input schema / properties / config / properties / campaignAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / properties / labelAdded value: +{ + "description": "Required visible link, button or QR label.", + "type": "string" +} - added
Input schema / properties / config / properties / mediumAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / properties / qrAdded value: +{ + "properties": { + "backgroundColor": { + "description": "Six-digit hex color.", + "type": "string" + }, + "foregroundColor": { + "description": "Six-digit hex color.", + "type": "string" + }, + "logoDataUrl": { + "description": "Optional PNG, JPEG or WebP data URL, at most 256 KB.", + "type": "string" + }, + "removeLogoBackground": { + "type": "boolean" + }, + "size": { + "description": "100–2000 pixels.", + "type": "integer" + } + }, + "type": "object" +} - added
Input schema / properties / config / properties / sourceAdded value: +{ + "type": "string" +} - added
Input schema / properties / config / requiredAdded value: +[ + "label" +] - added
Input schema / properties / flowIdAdded value: +{ + "type": "string" +} - added
Input schema / properties / kindAdded value: +{ + "enum": [ + "referral_link", + "qr_code", + "website_button" + ], + "type": "string" +} - added
Input schema / properties / slugAdded value: +{ + "type": "string" +} - added
Input schema / properties / status / descriptionAdded value: +"Disabled stops shared links and printed codes; paused is a legacy alias for disabled." - changed
Input schema / properties / status / enumPrevious value: -[ - "draft", - "active", - "paused" -]New value: +[ + "draft", + "active", + "disabled", + "paused" +]
- Changed
update_messenger_menu6 fields changed- added
Input schema / properties / items / descriptionAdded value: +"Top-level Flow or HTTPS website actions. Saving pins the current published Messenger Flow version for this exact Facebook Page." - added
Input schema / properties / items / itemsAdded value: +{ + "properties": { + "flowId": { + "description": "Published Flow id for a flow action.", + "type": "string" + }, + "id": { + "description": "Stable local item id.", + "type": "string" + }, + "label": { + "description": "Visible action text.", + "type": "string" + }, + "type": { + "enum": [ + "flow", + "website" + ], + "type": "string" + }, + "url": { + "description": "HTTPS URL for a website action.", + "type": "string" + } + }, + "required": [ + "id", + "label", + "type" + ], + "type": "object" +} - added
Input schema / properties / items / maxItemsAdded value: +20 - added
Input schema / properties / items / minItemsAdded value: +1 - removed
Input schema / properties / items / propertiesRemoved value: -{} - changed
Input schema / properties / items / typePrevious value: -"object"New value: +"array"
- Removed
update_podcast_episode - Removed
update_podcast_show - Changed
update_report2 fields changed- added
Input schema / properties / brandingAdded value: +{ + "description": "Hive report colors and header/footer notes. Use upload_report_logo to change the logo.", + "type": "object" +} - added
Input schema / properties / coverUrlAdded value: +{ + "description": "Hive report cover image URL; null removes the cover.", + "type": [ + "string", + "null" + ] +}
- Changed
upload_media_from_url3 fields changed- added
Input schema / properties / channelGroupIdAdded value: +{ + "description": "An accessible channel group from read_media_library. Required when the library saves assets per group.", + "type": "string" +} - added
Input schema / properties / fileAdded value: +{ + "additionalProperties": false, + "properties": { + "download_url": { + "type": "string" + }, + "file_id": { + "type": "string" + }, + "file_name": { + "type": "string" + }, + "mime_type": { + "type": "string" + } + }, + "required": [ + "download_url", + "file_id" + ], + "type": "object" +} - changed
Input schema / requiredPrevious value: -[ - "url", - "idempotencyKey" -]New value: +[ + "idempotencyKey" +]
- Added
write_workspace_operation
239 tool updates
- First observed
add_bio_block - First observed
add_competitor - First observed
add_contact_note - First observed
add_thread_note - First observed
approve_post - First observed
archive_flow - First observed
assign_review - First observed
assign_thread - First observed
cancel_job - First observed
cancel_scheduled_post - First observed
compare_listening - First observed
create_advanced_view - First observed
create_advocacy_group - First observed
create_advocacy_item - First observed
create_ai_intent - First observed
create_ai_knowledge - First observed
create_ai_policy - First observed
create_approval_workflow - First observed
create_bio_short_link - First observed
create_broadcast - First observed
create_campaign - First observed
create_contact_field - First observed
create_default_reply - First observed
create_draft - First observed
create_entry_point - First observed
create_flow - First observed
create_flow_from_brief - First observed
create_idea - First observed
create_keyword_rule - First observed
create_listening_alert - First observed
create_listening_query - First observed
create_messenger_menu - First observed
create_planning_card - First observed
create_podcast_episode - First observed
create_podcast_show - First observed
create_recurring_post - First observed
create_report - First observed
create_saved_reply - First observed
create_segment - First observed
create_sequence - First observed
create_simple_automation - First observed
create_tag - First observed
delete_ai_intent - First observed
delete_ai_knowledge - First observed
delete_approval_workflow - First observed
delete_campaign - First observed
delete_default_reply - First observed
delete_draft - First observed
delete_keyword_rule - First observed
delete_listening_alert - First observed
delete_listening_query - First observed
delete_podcast_episode - First observed
delete_podcast_show - First observed
delete_recurring_post - First observed
delete_report - First observed
delete_report_schedule - First observed
delete_saved_reply - First observed
delete_segment - First observed
delete_tag - First observed
delete_thread_note - First observed
describe_bio_blocks - First observed
describe_flow_nodes - First observed
duplicate_flow - First observed
duplicate_post - First observed
enroll_contact_in_sequence - First observed
export_report - First observed
fetch - First observed
install_flow_template - First observed
label_review - First observed
list_automation_recipes - First observed
list_connected_accounts - First observed
move_planning_card - First observed
patch_flow - First observed
pause_automation - First observed
pause_automation_flow - First observed
pause_contact_automations - First observed
pause_publishing - First observed
preflight_broadcast - First observed
publish_bio_page - First observed
publish_now - First observed
queue_competitor_refresh - First observed
rate_ai_reply - First observed
read_advanced_views - First observed
read_advocacy - First observed
read_advocacy_groups - First observed
read_ai_intents - First observed
read_ai_knowledge - First observed
read_ai_policies - First observed
read_ai_runs - First observed
read_analytics_summary - First observed
read_approval_workflows - First observed
read_attribution - First observed
read_automation_flow - First observed
read_automation_results - First observed
read_automations - First observed
read_benchmarks - First observed
read_best_times - First observed
read_bio_audience - First observed
read_bio_insights - First observed
read_bio_page - First observed
read_bio_qr - First observed
read_bio_short_links - First observed
read_broadcast - First observed
read_broadcasts - First observed
read_calendar - First observed
read_campaigns_and_tags - First observed
read_channel_health - First observed
read_channel_report - First observed
read_channel_settings - First observed
read_channels - First observed
read_community_post - First observed
read_community_posts - First observed
read_competitors - First observed
read_contact - First observed
read_contact_fields - First observed
read_contacts - First observed
read_content_page - First observed
read_deep_report - First observed
read_default_replies - First observed
read_eligible_posts - First observed
read_eligible_stories - First observed
read_entry_point_qr - First observed
read_entry_points - First observed
read_flow_document - First observed
read_flow_templates - First observed
read_flow_versions - First observed
read_inbox_analytics - First observed
read_inbox_summary - First observed
read_inbox_threads - First observed
read_inbox_views - First observed
read_job_page - First observed
read_jobs - First observed
read_keyword_rules - First observed
read_listening - First observed
read_listening_alerts - First observed
read_listening_benchmarks - First observed
read_listening_forecast - First observed
read_listening_trends - First observed
read_media_library - First observed
read_messenger_menus - First observed
read_pending_approvals - First observed
read_planning_board - First observed
read_planning_boards - First observed
read_podcast_episodes - First observed
read_podcasts - First observed
read_portfolio - First observed
read_post_performance - First observed
read_posts - First observed
read_pricing - First observed
read_product_knowledge - First observed
read_queue - First observed
read_recommendations - First observed
read_recurring_posts - First observed
read_report - First observed
read_report_data - First observed
read_report_schedules - First observed
read_reports - First observed
read_resolution_reasons - First observed
read_review - First observed
read_review_labels - First observed
read_reviews - First observed
read_saved_replies - First observed
read_segments - First observed
read_sequence - First observed
read_sequences - First observed
read_team - First observed
read_team_roles - First observed
read_thread - First observed
read_thread_notes - First observed
reject_post - First observed
remove_bio_block - First observed
remove_competitor - First observed
rename_flow - First observed
reopen_thread - First observed
reorder_bio_blocks - First observed
reply_to_comment - First observed
reply_to_review - First observed
request_changes_on_post - First observed
request_post_approval - First observed
reschedule_post - First observed
resolve_thread - First observed
resolve_threads - First observed
restore_deleted_post - First observed
restore_flow_version - First observed
resume_contact_automations - First observed
resume_publishing - First observed
schedule_post - First observed
schedule_report_email - First observed
search - First observed
search_inbox - First observed
send_direct_message - First observed
set_advocacy_lifecycle - First observed
set_automation_live - First observed
set_bio_design - First observed
set_bio_header - First observed
set_bio_profile - First observed
set_broadcast_status - First observed
set_contact_consent - First observed
set_enrollment_status - First observed
set_member_role - First observed
set_sequence_status - First observed
share_report - First observed
shuffle_queue - First observed
suggest_reply - First observed
tag_thread - First observed
test_flow - First observed
try_ai_reply - First observed
unarchive_flow - First observed
unpublish_bio_page - First observed
unshare_report - First observed
update_advocacy_item - First observed
update_ai_intent - First observed
update_ai_knowledge - First observed
update_ai_policy - First observed
update_approval_workflow - First observed
update_bio_block - First observed
update_broadcast - First observed
update_campaign - First observed
update_channel_settings - First observed
update_contact - First observed
update_default_reply - First observed
update_draft - First observed
update_entry_point - First observed
update_flow_document - First observed
update_keyword_rule - First observed
update_listening_query - First observed
update_messenger_menu - First observed
update_planning_card - First observed
update_podcast_episode - First observed
update_podcast_show - First observed
update_report - First observed
update_saved_reply - First observed
update_segment - First observed
update_sequence - First observed
update_simple_automation - First observed
update_tag - First observed
update_thread_note - First observed
upload_media_from_url - First observed
validate_post
Related MCP Connectors
- IgnixOAuthsocial.ignix
Schedule posts, automate DMs and comments, and work one inbox across 14 social networks.
Schedule and publish social posts to 12 platforms with first comments, analytics, and listening.
- PostZenOAuthdev.postzen
Schedule and publish social posts, manage the inbox, and read analytics across 10 platforms
Schedule, publish, and analyze social media across 15+ platforms, plus inbox, ads, and analytics.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenancePublish, schedule and read analytics across every major social network from one MCP server. 15+ tools covering publishing, scheduling, validation, media upload and normalised cross-platform analytics.2MIT

Markaestroofficial
AlicenseAqualityBmaintenanceSchedule, publish, and measure social posts on Facebook, Instagram, TikTok, LinkedIn, Threads, Pinterest, and X for one brand or many.34MIT- AlicenseAqualityAmaintenanceSchedule and manage social media posts across 13 platforms (Bluesky, Threads, Instagram, LinkedIn, Mastodon, YouTube, Facebook, Pinterest, Telegram, Nostr, X/Twitter, Discord, Tumblr and more). OAuth 2.0 + PKCE, 10 tools, draft-first workflow for AI agents.1017AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables posting and managing content across 13+ social media platforms with scheduling, analytics, AI generation, and approval workflows through natural language.2MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.