Joinmastodon Mastodon API

Name: Mastodon API
Brand: Mastodon API
Availability: InStock

✓ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Mastodon API

Explore with Jentic

View OpenAPI Document

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Mastodon bearer token, scoped to its instance, is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'post to Mastodon' or 'boost a status', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

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. Get started with Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the Mastodon API?

Yes. Because you run Jentic One yourself, you decide which Mastodon operations your agent may call, so read-only actions like fetching a thread with GET /statuses/{id}/context or favouriting and boosting a post can be allowed while destructive ones like DELETE /statuses/{id} are left out. Since the status id sits in the URL path, a rule can even pin the agent to a single status, letting it fetch context or reblog that one post and nothing else. The bearer token stays with your own instance and is injected at call time, so the agent only ever exercises the operations your rules permit.

Joinmastodon Mastodon API

Connect the Mastodon API to your agent

Capabilities

Start building with Mastodon API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs