Every workflow starts the same way:
rheos_get_capabilities to see what is usable, rheos_list_brands to find the brand, then rheos_get_brand_context to load its voice, audiences, themes and connected platforms. The recipes leave those calls out. Assume they happen first.1. Draft a post from a URL
Goal: “Read this article and write a LinkedIn post about it in my brand voice.”1
Read the page
Have the assistant fetch the page text itself. Most AI tools can read a web page.
2
Write the body
The assistant writes the post text itself. No tool call is needed. The brand voice comes from the context loaded first.
3
Save the draft
Call
rheos_create_post. For a business brand, the LinkedIn channel is linkedin_org:4
Review or schedule
The post now shows in the dashboard. If the user is happy, call
rheos_schedule_post with an ISO timestamp in the future, or rheos_publish_post to go out now. Both are real actions on the brand’s connected accounts, so confirm with the user first. The post’s channel must be connected. Otherwise scheduling is refused with channel_not_connected.2. One-shot post from an image
Goal: “Here’s a photo from yesterday’s event. Draft an Instagram post.” The fast path isrheos_draft_post_from_image, which uploads the image and drafts a caption in one call:
image_url for a link to the photo. image_base64 is for small images only, about 100 KB or less. channels: ["instagram"] keeps the draft to one platform. If you leave channels out, the draft is made for every connected channel.
The response includes the new post_id and asset_id. To tweak the caption, follow up with rheos_update_post. Then schedule or publish as in workflow 1.
Use
rheos_upload_image instead when you want to stage the image for later, for example to upload a batch of product shots before you decide which goes with which post.3. Schedule a week of content
Goal: “Plan five posts for next week. LinkedIn on Monday, Wednesday and Friday, Instagram on Tuesday and Thursday.”1
Brainstorm the ideas
Call
rheos_add_ideas_to_plan with count: 5 and any topic the user gave. It saves five ideas as posts with status="idea" and returns their idea_ids.2
Present and refine
Show the ideas to the user. If they want a different direction, call
rheos_add_ideas_to_plan again with a new prompt.3
Accept the keepers
For each idea the user picks, call
rheos_turn_idea_into_draft to flip its status to draft.4
Write each body
The assistant writes each post body in the brand voice, then
rheos_update_post saves it:5
Schedule each one
Call Check each post’s channel is connected first with
rheos_schedule_post for each post, with the scheduled_at you chose. It must be an ISO 8601 time in the future.rheos_list_connected_accounts. A channel that is definitely not connected refuses the call with channel_not_connected.Instagram posts need an image or video attached. Without one, the call is refused with media_required. If the account has reached its weekly post limit, the call returns weekly_quota_exceeded.rheos_cancel_scheduled_post.
4. Fill in a brand
Goal: “Add our three services and our two main customer groups to the brand.”1
See what the brand has
The context loaded first shows the brand’s current audiences.
rheos_list_audiences lists them again at any point.2
Add the offerings
Call
rheos_add_offering once per product or service. Use kind: "differentiator" for a reason the business stands out.3
Add the audiences
Call
rheos_add_audience once per customer group, with their pains and desires if the user knows them.4
Fill in the details
Call
rheos_update_brand_metadata for fields such as tagline, industry or website_url. Only the fields you pass change.5
Keep the ids
Each add call returns the new item’s
id. Keep it: rheos_update_offering, rheos_remove_offering, rheos_update_audience and rheos_archive_audience need it.5. Fill this week’s plan
Goal: “What does our plan still need this week? Draft those posts.”1
List the open slots
Call Each slot has a
rheos_list_open_slots:slot_id, a date, a funnel stage (tof awareness, mof consideration, bof conversion), a piece (video, carousel, or null for any post) and the account it posts from. A slot may also carry its planned pillar and topic. If exists is false, the brand has no strategy yet: set one up in the Rheos dashboard first.2
Write each post
The assistant writes a post for each slot, for that slot’s platform and funnel stage. When a slot has a
pillar and topic, the assistant offers them as the starting point, and the user can change them.3
Fill the slot
Call
rheos_create_post with the slot_id, exactly as returned, and leave out brand_id. The slot sets the post’s brand, platform, stage and date.4
Check what's left
Call
rheos_list_open_slots again. A filled slot no longer appears. If a slot was filled in the meantime, rheos_create_post returns slot_not_open.6. Connect a new social channel
Goal: “Connect this brand’s Instagram account.” Connecting happens in a browser. The connector can’t finish it for you.You can connect Instagram, Facebook, LinkedIn and X. Other networks are not open for new connections.
rheos_list_connected_accounts reports them as unavailable, with the reason.1
Get the link
Call
rheos_get_connect_link with channel: "instagram" and the brand_id. It returns a connect_url on dashboard.rheos.app for the user to open. The response status is url_handoff_required, which does not mean the account is connected yet.2
User opens it
The assistant asks the user to open the link, sign in to the platform and approve.
3
Check
After approval, call
rheos_list_connected_accounts to confirm the channel is connected. The platform can then be used as a channels value on rheos_create_post. Until it is connected, rheos_schedule_post refuses a post for that channel with channel_not_connected.Tips
- Start every session with
rheos_get_capabilities. It shows what Rheos can do right now. Then callrheos_list_brandsandrheos_get_brand_context, which seed the assistant with brand voice, current audiences and themes. - Prefer one-shot tools.
rheos_draft_post_from_imagebeatsrheos_upload_image+rheos_create_post.rheos_get_brand_contextbeats five separate reference calls. - Read the
next_stephints. When a Rheos tool response includesnext_steporhint, it names the right follow-up call. The assistant should follow it. - Retry a failed publish the way the response says. A post that failed goes back to draft with
rheos_update_post, thenrheos_publish_postagain. A post that went out on some channels is never published again, because that would repost them. Copy it withrheos_duplicate_post, remove the live channels from the copy withrheos_update_post, then publish the copy. - When a setting blocks the assistant, read the account docs.
rheos_read_documentationsays what the person changes and where, for example to reconnect an account or allow publishing. - Report problems. When a Rheos tool errors, returns something wrong or cannot do what the user needed, the assistant can call
rheos_report_feedback. The report goes straight to the Rheos team. - Scheduling and publishing need publishing access. With an API key, that means a key created with Allow publishing selected. See Create an API key.

