Skip to main content
Concrete patterns for what Rheos in your chat looks like. Each one is a natural-language prompt. Your assistant works out which tools to call. Use them as a starting point for your own workflows.
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 is rheos_draft_post_from_image, which uploads the image and drafts a caption in one call:
Use 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 rheos_schedule_post for each post, with the scheduled_at you chose. It must be an ISO 8601 time in the future.
Check each post’s channel is connected first with 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.
The week shows on Home under Content Plan in the dashboard. The user can drag posts to other days in the calendar there. Or they can come back to the chat and say “cancel Wednesday’s post”, and the assistant calls 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 rheos_list_open_slots:
Each slot has a 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.
The posts are drafts in the plan. Schedule them as in workflow 3 when the user is happy.

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 call rheos_list_brands and rheos_get_brand_context, which seed the assistant with brand voice, current audiences and themes.
  • Prefer one-shot tools. rheos_draft_post_from_image beats rheos_upload_image + rheos_create_post. rheos_get_brand_context beats five separate reference calls.
  • Read the next_step hints. When a Rheos tool response includes next_step or hint, 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, then rheos_publish_post again. A post that went out on some channels is never published again, because that would repost them. Copy it with rheos_duplicate_post, remove the live channels from the copy with rheos_update_post, then publish the copy.
  • When a setting blocks the assistant, read the account docs. rheos_read_documentation says 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.
Last modified on November 19, 2026