Skip to content

Docs / All tools / Base tools

bluesky.post_browser

Publish a post from the connected Bluesky account.

40 credits. Per post. 0 when cancelled.

Example prompt

Send this to your AI app when Heelo is connected:

Post to Bluesky: 'Excited to share Heelo's new auto-research tools!'

Input fields

FieldTypeDescription
queryRequiredstringNatural-language request to post on Bluesky
mediaarray of stringOptional list of photo/video URLs to attach (a local path must be in the user's uploads folder)
verbatimbooleanTrue: `query` is the whole post text, posted exactly as given (used by loop1.run and channel.expand)

Output fields

The fields in data when status is success.

FieldTypeDescription
contentstring
answerstring
urlstringThe post's bsky.app permalink, when the post's URI was read
uristringThe post's at:// URI, when it was read
link_cardbooleanTrue when the post carries a link card; None if unknown
link_card_imagebooleanTrue when that link card has an image (the page's og:image); None if there is no card
link_card_reasonstringWhy the post has no link card, or why its card has no image; None when the card is complete

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/bluesky.post_browser/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "query": "Post to Bluesky: 'Excited to share Heelo's new auto-research tools!'",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())