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

33.3/100 thin ▬ flat Agent 24/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessFreemium

16 APIs

CommunitiesForumsOpen-Source

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 33.3/100 · thin

Contract Quality 10.8 / 25

Developer Ergonomics 3.3 / 20

Access Clarity 8.9 / 20

Operational Transparency 3.8 / 13

Contract Governance 0.0 / 12

Discoverability 6.5 / 10

Agent readiness — 24/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

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.

Open Collections 18

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

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.

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