Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Commune 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcommmune.com%2Fcommune" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcommmune.com%2Fcommune" | 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.
What an agent can do with Commune API.
List every community accessible to the authenticated token via GET /communities
Fetch a single community record by id via GET /communities/{id}
List members across a community via GET /members
Read posts published in a community via GET /posts
Create a new post in a community via POST /posts
GET STARTED
List scheduled and past events via GET /events
Patterns agents use Commune API for, with concrete tasks.
★ Cross-Post Announcements from a CMS
When an editorial CMS publishes an article, mirror the headline and link into Commune by calling POST /posts. The community manager sets the destination community id once, and every published article fans out automatically. Useful for keeping members informed without manual reposting.
POST a new post to /posts with title 'New Article Live' and body containing the article URL
Member Directory Sync
Pull GET /members on a schedule and reconcile against an internal source-of-truth (HRIS or CRM) to detect new joiners and leavers. Combined with GET /communities, this gives a current map of who belongs to which community for downstream segmentation.
List members via /members and join with an internal CRM email list to find members who have not been contacted this month
Event Calendar Aggregation
Surface Commune events alongside other calendar sources (Google Calendar, Eventbrite) in an internal portal. GET /events returns the event list which can be normalised into a unified schedule view, so members see one calendar instead of several tabs.
Fetch all events from /events and normalise them into a calendar JSON with title, start_at, and url fields
AI Community Manager via Jentic
An AI agent connected to Jentic can draft an announcement, post it to Commune, and confirm members can see it - all without raw key exposure. Jentic stores the bearer token in your Jentic One instance and returns only execution results to the agent context.
Use Jentic to search 'create a post in commune', load POST /posts, and execute with a draft announcement
7 endpoints — jentic publishes the only available openapi specification for commune api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/communities
List communities
/communities/{id}
Get a single community
/members
List members
/posts
List posts
/posts
Create a post
/posts/{id}
Get a single post
/events
List events
/communities
List communities
/communities/{id}
Get a single community
/members
List members
/posts
List posts
/posts
Create a post
/posts/{id}
Get a single post
/events
List events
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Commune by hand means learning its bearer auth, mapping its community, member, and post resources, and handling pagination yourself. Through Jentic you install once, import Commune from the API Directory, store the token once, and your agent calls it.
Permission scoping
Commune puts the community and post ids in the URL path (/communities/{id}, /posts/{id}), so a rule can pin your agent to reading a specific community or post. You choose the operations it may call, so you can allow reads and post creation while leaving anything else out unless you add it.
Credential isolation
Your Commune bearer token 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 'list community members' or 'create a community post', and Jentic returns the matching Commune operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Commune API through Jentic.
Why is there no official OpenAPI spec for Commune API?
Commune does not publish an OpenAPI specification. Jentic generates and maintains this spec so AI agents and developers can call Commune via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Commune API use?
Commune uses a bearer token in the Authorization header. Through Jentic, the token is stored encrypted in your Jentic One instance and never enters the agent's context - the agent only receives the response of the operation it called.
Can I create posts in a Commune community?
Yes. POST /posts creates a new post in a target community; the request body includes the community reference, post title, and body content. This is the only write endpoint in the v2 spec.
What are the rate limits for the Commune API?
Commune does not document a public rate limit. In practice, modest paginated reads work reliably; if 429 responses appear, back off and retry. Avoid posting in tight loops to prevent member-facing spam.
How do I create a Commune post through Jentic?
Search Jentic for 'create a post in commune', load the schema for POST /posts, and execute with the title and body. The Jentic Python SDK pattern is await client.search(...), await client.load(...), await client.execute(...).
Does the Commune API support listing events?
Yes. GET /events returns events scheduled in the community, including upcoming and past entries. Combine with /communities to scope events to a specific community.
Can I limit what my agent is allowed to do with the Commune API?
Yes. Jentic One is self-hosted by you, so your own rules decide which Commune operations the agent may call and which credentials it may use. You can allow only reads such as GET /communities, GET /members, GET /posts, and GET /events, and grant POST /posts for creating announcements while leaving every other operation out. Because Commune puts community and post ids in the URL path (/communities/{id}, /posts/{id}), a rule can also pin the agent to a single community or post.
Know of an official OpenAPI document? Contribute it →
For Agents
List communities, members, and events on Commune, and create new posts in a community via one bearer token.
Use for: List all Commune communities I have access to, Get the details of a specific Commune community by id, List members of my Commune community, Read the latest posts in a Commune community
Not supported: Does not handle direct messaging, payments, or course content - use for community post, member, and event read access plus post creation only.
Jentic publishes the only available OpenAPI specification for Commune API, keeping it validated and agent-ready. Commune is a Japanese community management and engagement platform; the v2 API exposes a small core surface for listing communities, fetching community detail, listing members, reading and creating posts, and listing events. The post creation endpoint is the only write operation in the spec - everything else is read access. Use it to mirror community activity, drive notification systems, or let an agent post announcements on your behalf.