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 Communities, Forums, and Open-Source.

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

🌐 Visit website 📡 Source on GitHub

34.5/100 thin ▬ flat Agent 20/100 agent aware open core · MIT Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessFreemium

1 APIs

Communities Forums Open-Source

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 34.5/100 · thin

Contract Quality 9.4 / 23

Developer Ergonomics 3.0 / 18

Access Clarity 8.0 / 18

Operational Transparency 3.4 / 12

Contract Governance 0.0 / 11

Discoverability 5.3 / 9

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

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.

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 →

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

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
tags:
- Communities
- Forums
- Open-Source
tags_raw:
- Communities
- Forums
- Open Source
created: '2023-11-13'
modified: '2026-05-19'
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 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:
  - 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: 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.