Joinmastodon Mastodon API
✓ Official Vendor SpecSocial MediaSocial Publishingbearer22 EndpointsREST
For Agents
Post and edit Mastodon statuses, boost or favourite posts, manage bookmarks and pins, translate content, and walk thread context — all against any Mastodon instance the user authenticates against.
Use for: I need to post a status to my Mastodon account about a product launch, Edit my last Mastodon post to fix a typo, Delete the Mastodon status with ID 12345, Boost the Mastodon post linked in this message
Not supported: Does not handle account follow management, direct messages, instance administration, or media upload — use for status-level publishing, interactions, and thread retrieval only.
Mastodon is a federated, open-source social network where each instance hosts its own users while interoperating across the wider fediverse. This subset of the Mastodon API focuses on the statuses surface — posting, editing, deleting, boosting, favouriting, bookmarking, pinning, and translating posts, plus retrieving conversation context and edit history. It is the right toolkit when an agent needs to publish to a Mastodon instance or moderate a thread on behalf of a user.
Install Jentic One Beta
Connect the Mastodon API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Mastodon API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Mastodon API.
Post a new status to a Mastodon instance with visibility and language settings
Edit or delete a previously published status and inspect its edit history
Boost (reblog) and unboost a status to amplify it on the user's timeline
Favourite, bookmark, or pin a status, with matching undo operations
Mute a conversation thread to suppress notifications without leaving it
Retrieve a status's parent and child context to walk a full thread
Translate a status into another language using the instance's translation backend
Use Cases
Patterns agents use Mastodon API for, with concrete tasks.
★ Cross-post to Mastodon from a content workflow
Marketing or community teams publishing on multiple networks can mirror posts to Mastodon by calling POST /statuses with the rendered text, visibility, and language. The endpoint returns the new status's ID, which can be stored alongside cross-post metadata for later editing or deletion. This works against any Mastodon instance, so brands hosted on their own servers and those on mastodon.social use the same call.
Call POST /statuses with status text 'New release shipped today — details on the blog' and visibility 'public' to publish to the user's instance
Walk a thread and summarise the conversation
Researchers and community managers can pull the full context around a status — both ancestors and descendants — using GET /statuses/{id}/context. The response groups parents and children separately, making it straightforward to render a threaded view or feed an LLM a complete conversation for summarisation. Pair this with the source endpoint to inspect the original markdown of the focal post.
Call GET /statuses/{id}/context for the focal status, concatenate ancestor and descendant statuses, and feed the joined text to the assistant for summarisation
Curate a personal bookmark and pin set
Power users who treat their Mastodon profile as a curated feed can manage pins and bookmarks programmatically. POST /statuses/{id}/bookmark saves a post for later, POST /statuses/{id}/pin highlights it on the profile, and the matching unpin and unbookmark endpoints reverse the action cleanly. This is useful for daily-digest bots that pin a featured post each morning.
Call POST /statuses/{id}/pin to feature the morning announcement, then POST /statuses/{previous_id}/unpin to remove yesterday's pinned status
Agent-driven Mastodon posting via Jentic
An AI assistant can be granted scoped Mastodon access through Jentic so it can publish on behalf of a user without ever holding the access token in memory. The agent expresses intent ('post my weekly update to Mastodon'), Jentic resolves to POST /statuses, injects the bearer token, and returns the new status URL. Multi-instance support is handled through the {instance} server template.
Use Jentic to search 'post to Mastodon', load POST /statuses, and execute it with the user's stored bearer token to publish a weekly update
Key Endpoints
22 endpoints — mastodon is a federated, open-source social network where each instance hosts its own users while interoperating across the wider fediverse.
METHOD
PATH
DESCRIPTION
POST
/statuses
Post a new status
GET
/statuses/{id}
View a single status
PUT
/statuses/{id}
Edit a status
DELETE
/statuses/{id}
Delete a status
GET
/statuses/{id}/context
Get parent and child statuses
POST
/statuses/{id}/favourite
Favourite a status
POST
/statuses/{id}/reblog
Boost a status
POST
/statuses/{id}/translate
Translate a status
POST
/statuses
Post a new status
GET
/statuses/{id}
View a single status
PUT
/statuses/{id}
Edit a status
DELETE
/statuses/{id}
Delete a status
GET
/statuses/{id}/context
Get parent and child statuses
POST
/statuses/{id}/favourite
Favourite a status
POST
/statuses/{id}/reblog
Boost a status
POST
/statuses/{id}/translate
Translate a status
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Mastodon bearer tokens are scoped per instance and stored encrypted in the Jentic vault. Tokens are injected as Authorization: Bearer headers at call time and never enter the agent's prompt or transcript.
Intent-based discovery
Agents search Jentic with intents like 'post to Mastodon' or 'boost a status' and Jentic returns the matching operation with its input schema, so the agent doesn't have to read docs.joinmastodon.org.
Time to first call
Direct Mastodon integration: 1-2 days to handle the per-instance OAuth dance, token storage, and error handling. Through Jentic: under 1 hour once the user has authenticated their instance once.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Mastodon API through Jentic.
What authentication does the Mastodon API use?
The Mastodon API uses HTTP bearer authentication — an Authorization: Bearer {access_token} header obtained via the OAuth flow on the user's instance. Jentic stores tokens encrypted per-user and injects them at call time, keeping them out of the agent's context.
Can I post a status with the Mastodon API?
Yes. POST /statuses creates a new status with parameters for status text, visibility (public, unlisted, private, direct), and language. The response returns the new status's ID, URL, and account details, which you can use for subsequent edits or deletes.
How do I work with multiple Mastodon instances?
The base URL uses an {instance} template — every Mastodon server (mastodon.social, hachyderm.io, your self-hosted instance) implements the same endpoints. Configure the instance hostname per credential and the same operations apply across the fediverse.
How do I post to Mastodon through Jentic?
Search Jentic for 'post to Mastodon', load POST /statuses, and execute it with the user's instance bearer token. Jentic returns the created status, including its URL. Sign up at https://app.jentic.com/sign-up.
Can the Mastodon API translate a post into another language?
Yes. POST /statuses/{id}/translate asks the instance's configured translation backend to translate a status. Availability depends on the instance — admins can enable or disable the feature, so check the response status before relying on it.
How do I retrieve the full context of a Mastodon thread?
Call GET /statuses/{id}/context for the focal status. The response contains an 'ancestors' array (parents) and 'descendants' array (replies), letting you reconstruct the full conversation in a single call.
GET STARTED