Discourse

At Discourse, our mission is to democratize online community and teamwork by raising the standard of civilized discourse on the Internet. We achieve this through delivering the best community and forum software. The Discourse API exposes administrative and content endpoints for categories, topics, posts, users, groups, tags, uploads, badges, and more.

Discourse publishes 16 APIs on the APIs.io network, including Admin API, Backups API, Badges API, and 13 more. Tagged areas include Community, Forums, and Open Source.

Discourse’s developer surface includes documentation, engineering blog, support, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub

34.6/100 thin ▬ flat Agent 20/100 agent aware Front door AI 3/6 light open core · MIT Full breakdown ↓
scored 2026-09-25 · rubric v0.23.0

AccessFreemium

1 APIs

Community Forums Open Source

Kin Score

Kin Score How this is scored →
scored 2026-09-25 · rubric v0.23.0

Composite quality — 34.6/100 · thin

Contract Quality 7.1 / 19

Developer Ergonomics 2.5 / 15

Access Clarity 6.7 / 15

Operational Transparency 2.8 / 10

Contract Governance 0.0 / 9

Discoverability 4.3 / 8

Regulatory Posture 3.7 / 15

Create-or-Update Ergonomics 2.8 / 10

Agent readiness — 20/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/discourse: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Discourse is an area vendor: providers adopt it to run part of their developer surface. This is the Kin Score checks its features can move for a provider that adopts it, what each one really earns, and what it earns nothing for.

communitycapability map7 features checked 2026-09-25 · rubric v0.22.0

Discourse earns a provider one check reliably: support_channel, worth 2 points, and only half of that when the forum is declared as Community, because the pointer probe does not read that type and grades it “unverified”. Declared as Support, the forum is probed and Discourse forums come back live (5 of 5 probed). Topic voting (Business and up) can carry a public roadmap and a category can carry release notes, but only if the provider really uses them that way. The forum’s own API, embeds and chat earn the provider nothing.

Developer Ergonomics5.0 of 42 pts

Operational Transparency8.0 of 38 pts

Check	Earns	Through
Documentationsaturated Developer ErgonomicsOnly if the provider actually keeps its API documentation in doc categories and declares them as Documentation. Business plan and up.	4.0 of 4	Doc Categories
Support channeldiscounted Developer Ergonomics195 providers whose only support-class pointer is Community all score support_channel partial (“pointer liveness 0.5”), measured 2026-09-25. Discourse URLs that were probed as Support were 5 of 5 live.	1.0 of 2	Hosted community forum (free plan; custom domain on Pro and up)
Change logconditional Operational TransparencyDiscourse ships no changelog feature. Only if the provider posts release notes to a dedicated category and declares that category URL as ChangeLog.	6.0 of 6	Sitewide alerts and pinned topics
Public roadmapconditional Operational TransparencyOnly if the provider runs a public voting category as a roadmap (planned / in-progress states it maintains), not only as a request inbox, and declares it as RoadMap. Business plan and up.	2.0 of 2	Topic voting (ideas / feature-request categories)

Across 8977 providers that publish a contract, adopting Discourse would move 3701. Median lift: composite +0.0 (90th percentile +0.5), agent readiness +0.0 (+0.0). Conditional rows excluded.

What Discourse ships that earns nothing (2)

Blog integration (embedded comments) — It puts forum comments under a blog the provider already runs; it does not host a blog.
Discourse API and webhooks — Discourse’s API is Discourse’s, for administering the forum. It is not the provider’s API contract.

A model, not a score. Adopting this vendor changes a provider's Kin Score only when the provider publishes the resulting artifacts on its own surface; nothing here writes a score, and no sponsorship or partnership can. The rating is not for sale → · Full vendor facets artifact

APIs 16

Individual APIs this provider publishes, each with its own machine-readable definition.

Discourse Admin API

The Admin API from Discourse — 10 operation(s) for admin.

Discourse Backups API

The Backups API from Discourse — 2 operation(s) for backups.

Discourse Badges API

The Badges API from Discourse — 3 operation(s) for badges.

Discourse Categories API

The Categories API from Discourse — 5 operation(s) for categories.

Discourse Calendar - Events API

The Discourse Calendar - Events API from Discourse — 2 operation(s) for discourse calendar - events.

Discourse Groups API

The Groups API from Discourse — 8 operation(s) for groups.

Discourse Invites API

The Invites API from Discourse — 4 operation(s) for invites.

Discourse Notifications API

The Notifications API from Discourse — 2 operation(s) for notifications.

Discourse Posts API

The Posts API from Discourse — 5 operation(s) for posts.

Discourse Private Messages API

The Private Messages API from Discourse — 3 operation(s) for private messages.

Discourse Search API

The Search API from Discourse — 1 operation(s) for search.

Discourse Site API

The Site API from Discourse — 2 operation(s) for site.

Discourse Tags API

The Tags API from Discourse — 4 operation(s) for tags.

Discourse Topics API

The Topics API from Discourse — 14 operation(s) for topics.

Discourse Uploads API

The Uploads API from Discourse — 7 operation(s) for uploads.

Discourse Users API

The Users API from Discourse — 23 operation(s) for users.

Scroll for all 16

Open Collections 18

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Discourse API Documentation Admin API

OPEN COLLECTION

Discourse API Documentation Admin Backups API

OPEN COLLECTION

Discourse API Documentation Admin Badges API

OPEN COLLECTION

Discourse API Documentation Admin Categories API

OPEN COLLECTION

Discourse API Documentation Admin Discourse Calendar - Events API

OPEN COLLECTION

Discourse API Documentation Admin Groups API

OPEN COLLECTION

Discourse API Documentation Admin Invites API

OPEN COLLECTION

Discourse API Documentation Admin Notifications API

OPEN COLLECTION

Discourse API Documentation Admin Posts API

OPEN COLLECTION

Discourse API Documentation Admin Private Messages API

OPEN COLLECTION

Discourse API Documentation Admin Search API

OPEN COLLECTION

Discourse API Documentation Admin Site API

OPEN COLLECTION

Discourse API Documentation Admin Tags API

OPEN COLLECTION

Discourse API Documentation Admin Topics API

OPEN COLLECTION

Discourse API Documentation Admin Uploads API

OPEN COLLECTION

Discourse API Documentation Admin Users API

OPEN COLLECTION

Discourse API Documentation

OPEN COLLECTION

Scroll for all 18

Pricing Plans 1

Published pricing tiers and plan structures.

Discourse Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Discourse Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Discourse Finops

FINOPS

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Discourse Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Discourse Vulnerability Disclosure

Hackerone

SECURITY

Discourse Trust Center

SOC 2, ISO 27001

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Discourse Agentic Access

93 operations · 53 acting · 2 human-in-the-loop

93 operations · 53 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Build 3

SDKs, sample code, and the tooling you integrate with

Plugins

Plugins

GitHubRepo

GitHubRepo

GitHubOrg

GitHubOrg

Access & Security 3

Authentication, authorization, and security posture

TrustCenter

TrustCenter

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Operate 3

Status, limits, changes, and where to get help

Community

Community

StatusPage

StatusPage

Support

Support

Commercial 4

Pricing, plans, and the legal terms of use

License

Plans

PrivacyPolicy

TermsOfService

Company 3

The organization behind the API

LinkedIn

Website

Website

Blog

Blog

Other 1

Properties that don't map to a standard resource type

VendorFacets

VendorFacets

Source (apis.yml)

aid: discourse
name: Discourse
description: At Discourse, our mission is to democratize online community and teamwork by raising the standard of civilized
  discourse on the Internet. We achieve this through delivering the best community and forum software. The Discourse API exposes
  administrative and content endpoints for categories, topics, posts, users, groups, tags, uploads, badges, and more.
url: https://raw.githubusercontent.com/api-evangelist/discourse/refs/heads/main/apis.yml
type: Index
deliveryModel:
  model: open-core
  license: MIT
  open_source: true
  commercial: true
  callable_host: false
  label: Open core · an OSS project plus a commercial hosted product
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/discourse.png
x-docs-platform: redocly
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-09-25
x-docs-hosting: github-pages
tags:
- Community
- Forums
- Open Source
tags_raw:
- Communities
- Forums
- Open Source
- Open-Source
created: '2023-11-13'
modified: '2026-09-16'
specificationVersion: '0.23'
apis:
- aid: discourse:discourse-admin-api
  name: Discourse Admin API
  description: The Admin API from Discourse — 10 operation(s) for admin.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Admin
  properties:
  - type: OpenAPI
    url: openapi/discourse-admin-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-backups-api
  name: Discourse Backups API
  description: The Backups API from Discourse — 2 operation(s) for backups.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Backups
  properties:
  - type: OpenAPI
    url: openapi/discourse-backups-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-badges-api
  name: Discourse Badges API
  description: The Badges API from Discourse — 3 operation(s) for badges.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Badges
  properties:
  - type: OpenAPI
    url: openapi/discourse-badges-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-categories-api
  name: Discourse Categories API
  description: The Categories API from Discourse — 5 operation(s) for categories.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Categories
  properties:
  - type: OpenAPI
    url: openapi/discourse-categories-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-discourse-calendar-events-api
  name: Discourse Calendar - Events API
  description: The Discourse Calendar - Events API from Discourse — 2 operation(s) for discourse calendar - events.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Discourse Calendar - Events
  properties:
  - type: OpenAPI
    url: openapi/discourse-discourse-calendar-events-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-groups-api
  name: Discourse Groups API
  description: The Groups API from Discourse — 8 operation(s) for groups.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Group
  tags_raw:
  - Groups
  properties:
  - type: OpenAPI
    url: openapi/discourse-groups-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-invites-api
  name: Discourse Invites API
  description: The Invites API from Discourse — 4 operation(s) for invites.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Invites
  properties:
  - type: OpenAPI
    url: openapi/discourse-invites-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-notifications-api
  name: Discourse Notifications API
  description: The Notifications API from Discourse — 2 operation(s) for notifications.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Notification
  tags_raw:
  - Notifications
  properties:
  - type: OpenAPI
    url: openapi/discourse-notifications-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-posts-api
  name: Discourse Posts API
  description: The Posts API from Discourse — 5 operation(s) for posts.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Posts
  properties:
  - type: OpenAPI
    url: openapi/discourse-posts-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-private-messages-api
  name: Discourse Private Messages API
  description: The Private Messages API from Discourse — 3 operation(s) for private messages.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Private Messages
  properties:
  - type: OpenAPI
    url: openapi/discourse-private-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-search-api
  name: Discourse Search API
  description: The Search API from Discourse — 1 operation(s) for search.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/discourse-search-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-site-api
  name: Discourse Site API
  description: The Site API from Discourse — 2 operation(s) for site.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Site
  properties:
  - type: OpenAPI
    url: openapi/discourse-site-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-tags-api
  name: Discourse Tags API
  description: The Tags API from Discourse — 4 operation(s) for tags.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Tags
  properties:
  - type: OpenAPI
    url: openapi/discourse-tags-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-topics-api
  name: Discourse Topics API
  description: The Topics API from Discourse — 14 operation(s) for topics.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Topic
  tags_raw:
  - Topics
  properties:
  - type: OpenAPI
    url: openapi/discourse-topics-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-uploads-api
  name: Discourse Uploads API
  description: The Uploads API from Discourse — 7 operation(s) for uploads.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - Uploads
  properties:
  - type: OpenAPI
    url: openapi/discourse-uploads-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
- aid: discourse:discourse-users-api
  name: Discourse Users API
  description: The Users API from Discourse — 23 operation(s) for users.
  humanURL: https://www.discourse.org/
  baseURL: https://meta.discourse.org
  tags:
  - User
  tags_raw:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/discourse-users-api-openapi.yml
  - type: Documentation
    url: https://docs.discourse.org/
  - type: GitHubRepo
    url: https://github.com/discourse/discourse_api
common:
- type: VendorFacets
  url: vendor-facets/discourse-vendor-facets.yml
- type: License
  name: MIT
  url: https://github.com/discourse/discourse_api/blob/main/LICENSE
- type: AgenticAccess
  url: agentic-access/discourse-agentic-access.yml
- type: TrustCenter
  url: security/discourse-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/discourse-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/discourse-domain-security.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/civilized-discourse-construction-kit-inc
- url: https://www.discourse.org/
  type: Website
- url: https://docs.discourse.org/
  type: Documentation
- url: https://meta.discourse.org/
  type: Community
- url: https://www.discourse.org/pricing
  type: Plans
- url: https://blog.discourse.org/
  type: Blog
- url: https://www.discourse.org/plugins
  type: Plugins
- url: https://www.discourse.org/integrations
  type: Integrations
- url: https://github.com/discourse/discourse
  type: GitHubRepo
- url: https://github.com/discourse
  type: GitHubOrg
- url: https://www.discourse.org/privacy
  type: PrivacyPolicy
- url: https://www.discourse.org/tos
  type: TermsOfService
- url: https://status.discourse.org/
  type: StatusPage
- url: https://meta.discourse.org/c/support/api/52
  type: Support
integrations:
- name: Google
- name: Facebook
- name: LinkedIn
- name: GitHub
- name: Discord
- name: Microsoft
- name: Apple
- name: Slack
- name: Mattermost
- name: Matrix
- name: Rocket Chat
- name: Telegram
- name: Zulip
- name: Gitter
- name: Slack chat with Discourse notification
- name: Google Adsense
- name: Google Ads
- name: Amazon
- name: CodeFund
- name: Discourse forum with banner ad
- name: Google Analytics
- name: Matomo
- name: Adobe Analytics Cloud
- name: Google Analytics data
- name: Patreon
- name: Memberful
- name: Patreon pledge tiers
- name: Discourse Github
- name: Zendesk
- name: Zendesk Discourse settings
- name: WordPress
- name: Zapier
- name: Skyvia
- name: Agolia
- name: BrightCove
- name: IFTTT
- name: Logo
- name: Discourse
- name: Get Discourse Hub on Google Play
maintainers:
- FN: Kin Lane
  url: http://apievangelist.com
  email: kin@apievangelist.com

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/discourse"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/discourse/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/discourse/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

Discourse

What adopting Discourse moves on the Kin Score 4

APIs 16

Open Collections 18

Pricing Plans 1

Rate Limits 1

FinOps 1

Security Posture 3

Agentic Access 1

Documentation 1

Agent Surfaces 1

Build 3

Access & Security 3

Operate 3

Commercial 4

Company 3

Other 1

Source (apis.yml)

MCP server

Tools for providers

Call it yourself

Get an API key