Discourse website screenshot

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 14 more developer resources.

🌐 Visit website 📡 Source on GitHub
40.4/100 thin ▬ flat Agent 25/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
16 APIs
CommunitiesForumsOpen Source

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 40.4/100 · thin
Contract Quality 10.4 / 25
Developer Ergonomics 3.0 / 20
Commercial Clarity 13.7 / 20
Operational Transparency 6.8 / 13
Governance 0.0 / 12
Discoverability 6.5 / 10
Agent readiness — 25/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
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
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. 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. Want it done for you? Prioritized profiling — $2,500 →

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 1

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

Discourse API Documentation

OPEN COLLECTION

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 3

Pricing, plans, and the legal terms of use

Plans
Plans
 PrivacyPolicy
PrivacyPolicy
 TermsOfService
TermsOfService

Company 3

The organization behind the API

LinkedIn
LinkedIn
 Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
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
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: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/discourse.png
tags:
- Communities
- Forums
- Open Source
created: '2023-11-13'
modified: '2026-05-19'
specificationVersion: '0.20'
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:
  - 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:
  - 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:
  - 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: 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