Tool reference

Assistants discover these tools on their own; you do not need to name them in your prompts. This page helps when you check what an assistant can do, set up an API key with limited scopes, or debug a tool call.

Tools marked asks first act in public or for good (publishing, retrying, deleting). They are flagged as destructive, so clients like Claude ask you before they run them.

get_context

Start here. Returns the organization, permissions, every profile with its time zone, current local time, queue state and connected accounts (ids, platform, status), and which platforms can publish. Call once per conversation before working with posts.

Reads only. Scope: any valid key.

No parameters.

get_platform_rules

Text length, media count and accepted file types per platform, plus rules such as "Instagram needs media". Use it to write text that fits before calling validate_post. Leave platforms empty for all.

Reads only. Scope: any valid key.

search_docs

Searches the FeedHorizon documentation (guides and API reference) by keywords and returns the best pages with an excerpt. Set fullText to get the whole text of the top page. Use it when unsure how something works.

Reads only. Scope: any valid key.

list_posts

Lists posts with a short preview, newest first. With from or to it lists a calendar range by publish time, oldest first. Filter by profile, status or platform. Pass nextCursor back as cursor for more. Use get_post for the full text.

Reads only. Scope: posts:read.

get_post

The full post: text, own text per account, media, schedule in UTC and local time, and per account the status, link to the published post or the error.

Reads only. Scope: posts:read.

validate_post

Checks a post against every platform (text length, media, accounts, time, queue) without saving it. Returns all errors and warnings at once. Times: when=at with date + time in the profile time zone, or at as ISO. Fix every error, then create the post.

Reads only. Scope: posts:read.

get_queue

A profile's posting queue: weekly slots in its time zone, whether it is on, and the next slots with the post that holds each (postId null = free). when=queue in validate_post takes the first free slot.

Reads only. Scope: profiles:read.

list_pinterest_boards

The boards of a connected Pinterest account. Pass a board id as options.pinterest.boardId on that account's target in create_post or update_post.

Reads only. Scope: accounts:read.

get_tiktok_creator

Before every TikTok post: the creator's name (tell the user which account it goes to), the privacy levels they may choose and which interactions are switched off. Ask the user for the privacy level and the comment, duet and stitch settings; never pick them yourself.

Reads only. Scope: accounts:read.

create_post

Saves a post as draft, schedules it (when=at with date + time in the profile time zone) or puts it in the queue (when=queue). Runs the same checks as validate_post and fails with all problems at once. To publish right away, create a draft and call publish_post_now.

Changes data. Scope: posts:write.

update_post

Changes a post that has not started publishing: text, accounts (targets replaces all), media (mediaIds replaces all, [] removes) or time (when=draft unschedules, at, or queue). Leave a field out to keep it.

Changes data. Scope: posts:write.

publish_post_now

Publishes a draft or scheduled post immediately to all its accounts. This is public and cannot be undone, so confirm with the user first. Returns at once with status scheduled; check the outcome with get_post after a few seconds.

Changes data, asks first. Scope: posts:write.

cancel_post

Takes a scheduled or queued post off the schedule. It stays as a draft and can be scheduled again with update_post.

Changes data. Scope: posts:write.

retry_post

Publishes the failed accounts of a post again, right away. Read the error in get_post first: a disconnected account fails again until the user reconnects it. Public, so confirm with the user.

Changes data, asks first. Scope: posts:write.

duplicate_post

Copies a post (also a published one) as a new draft with the same text, own texts, accounts and media. Then change or schedule the copy with update_post.

Changes data. Scope: posts:write.

delete_post

Deletes a post in FeedHorizon for good. Posts already live on a platform stay there. Confirm with the user first; to only stop a scheduled post, use cancel_post.

Changes data, asks first. Scope: posts:write.

set_queue_slots

Replaces all weekly queue slots of a profile, e.g. Mon-Fri 09:00. Times are local in the profile's time zone (or the new timezone you pass). reshuffle moves posts already waiting in the queue to the new slots. slots: [] clears the queue.

Changes data. Scope: profiles:write.

import_media_from_url

Downloads an image, video or PDF from a public https URL (up to 100 MB) and stores it. Returns the media id to pass in mediaIds. Use the direct file URL, not a web page that shows it.

Changes data. Scope: posts:write.

create_upload_link

For a local file you cannot share by URL: returns a media id and a link valid for two hours. The user or a script PUTs the raw bytes to uploadUrl with the given Content-Type; after that the media id works in mediaIds. Up to 5 GB.

Changes data. Scope: posts:write.

create_connect_link

A link to connect a social account to a profile, for the user or their client to open in a browser (valid 7 days, usable once). Accounts cannot be connected without that sign-in on the platform.

Changes data. Scope: platform_invites:write.