Bettermode API

Name: Bettermode API
Brand: Bettermode API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsChat Messagingbearer10 EndpointsREST

For Agents

Run GraphQL queries and mutations against a Bettermode community to manage members, posts, spaces, votes, and moderation reports.

Install Jentic One Beta

Connect the Bettermode API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bettermode 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 Bettermode API.

Run arbitrary GraphQL queries and mutations against a Bettermode network

Authenticate against a network using app or member access tokens

Create draft posts and invite members into a community

GET STARTED

Start building with Bettermode API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Bettermode API, keeping it validated and agent-ready. Bettermode (formerly Tribe) is a community platform exposing a GraphQL API for building custom community apps, automating workflows, syncing data, and extending core functionality. Operations cover members, posts, spaces, analytics, authentication, and moderation. The spec exposes the GraphQL entry points along with eight pre-shaped mutation aliases for common actions such as creating draft posts, inviting members, casting votes, and reporting moderation issues.

Use Cases

Patterns agents use Bettermode API for, with concrete tasks.

★ Community Member Onboarding

Automate onboarding when a user signs up for a SaaS product by inviting them into the community and adding them to onboarding-specific spaces. /graphql/inviteMembers handles the invitation and /graphql/addSpaceMembers wires them into the right spaces. End-to-end automation against a sign-up webhook is typically 1 day of work.

On a new user webhook, POST /graphql/inviteMembers with the email, then POST /graphql/addSpaceMembers to attach them to the welcome space

Editorial Posting Pipeline

Push articles or announcements from a CMS or marketing tool into Bettermode as draft posts ready for an editor to publish. /graphql/createDraftPost takes the title, body, and target space and returns the draft id, while tagging through /graphql/createTag keeps content organised. A baseline integration is typically half a day to a day.

POST /graphql/createDraftPost with the article title, body, and target space id, then POST /graphql/createTag for any new content tags

Moderation and Engagement Bots

Build a moderation bot that escalates flagged content via /graphql/createModerationReport and an engagement bot that reacts or votes on highlight posts via /graphql/addReaction and /graphql/castVote. The shared /graphql endpoint can run any other query needed for context, such as fetching post detail before deciding to escalate.

When a post matches a moderation rule, POST /graphql/createModerationReport with the post id and reason, then POST /graphql with a query to fetch the post for the audit log

AI Agent for Community Operations

An AI agent uses Jentic to discover Bettermode operations and automate community admin: inviting registrants, drafting weekly digest posts, or running moderation checks. The agent searches by intent, loads the operation schema, and executes against the GraphQL endpoint without learning the schema by hand. Through Jentic, integration takes under an hour.

Search Jentic for 'create bettermode draft post' and execute /graphql/createDraftPost with the weekly digest content for the announcements space

Key Endpoints

10 endpoints — jentic publishes the only available openapi specification for bettermode api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/graphql

Run any GraphQL query or mutation

POST

/graphql/loginNetwork

Authenticate against a network and obtain a token

POST

/graphql/createDraftPost

Create a draft post in a space

POST

/graphql/inviteMembers

Invite new members to the community

POST

/graphql/addSpaceMembers

Add members to a specific space

POST

/graphql/addReaction

React to a post

POST

/graphql/castVote

Cast a vote on a poll

POST

/graphql/createModerationReport

File a moderation report

POST

/graphql

Run any GraphQL query or mutation

POST

/graphql/loginNetwork

Authenticate against a network and obtain a token

POST

/graphql/createDraftPost

Create a draft post in a space

POST

/graphql/inviteMembers

Invite new members to the community

POST

/graphql/addSpaceMembers

Add members to a specific space

Why Jentic?

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

Credential isolation

Bettermode app and member access tokens are stored encrypted in the Jentic vault. Agents receive scoped execution rights — the Authorization header is injected at execution time and never appears in the agent's context window.

Intent-based discovery

Agents search Jentic by intent such as 'create bettermode draft post' or 'invite members to community' and Jentic returns the matching pre-shaped mutation with its parameter schema, removing the need to study the GraphQL schema by hand.

Time to first call

Direct Bettermode integration: 2 to 4 days to learn the GraphQL schema, design queries, and handle pagination. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Bettermode API through Jentic.

Why is there no official OpenAPI spec for Bettermode API?

Bettermode publishes a GraphQL schema rather than an OpenAPI specification. Jentic generates and maintains this OpenAPI spec so that AI agents and developers can call Bettermode API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Bettermode API use?

Bettermode uses HTTP Bearer authentication carrying a JWT app access token or member access token in the Authorization header. Tokens are issued via POST /graphql/loginNetwork. When called via Jentic, tokens are stored encrypted in the Jentic vault and injected at execution time so they never enter the agent's context.

Can I run arbitrary GraphQL queries through this API?

Yes. POST /graphql accepts any query or mutation supported by the Bettermode schema, while POST /graphql/member runs the same in a member-scoped context. The other /graphql/<operation> endpoints are pre-shaped wrappers for common mutations such as createDraftPost or addReaction.

How do I invite members through Jentic?

Run pip install jentic and search for 'invite members to bettermode community'. Jentic returns POST /graphql/inviteMembers, the agent loads the input schema, and executes with the email list and target role. Pair with /graphql/addSpaceMembers to land them in the right spaces.

What rate limits apply to the Bettermode API?

Bettermode applies per-token rate limits on the GraphQL endpoint that vary by plan. The OpenAPI spec does not encode these explicitly, so handle 429 responses with backoff and prefer the pre-shaped mutation aliases over composing many round-trips through /graphql when running bulk operations.

Is the Bettermode API free?

Bettermode is a paid community platform with multiple subscription tiers; API access is included with paid plans. There is no separate API charge, but call volume must stay within plan-specific quotas. Pricing tiers are available on bettermode.com.

Bettermode API

Connect the Bettermode API to your agent

Capabilities

Start building with Bettermode API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs