How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Vanilla Forums Discussions API

The Discussions API from Vanilla Forums — 28 operation(s) for discussions.

Vanilla Forums Discussions API is one of 58 APIs that Vanilla Forums publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Discussions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 34 operations across 28 paths, and defines 23 schemas. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against a single base URL, https://open.vanillaforums.com/api/v2.

34 operations 28 paths 23 schemas 4 DELETE9 GET7 PATCH7 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://open.vanillaforums.com/api/v2
Resource Areas
1

Paths & Operations 34

Across 28 paths, the API surfaces 34 operations — 4 DELETE, 9 GET, 7 PATCH, 7 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

Discussions 34
DELETE
/comments/list
Delete a list of comments.
body → 202204403408
GET
/discussions
List discussions.
37 params → 200
POST
/discussions
Add a discussion.
body → 201202
GET
/discussions/bookmarked
Get a list of the current user's bookmarked discussions.
4 params → 200
PATCH
/discussions/close
Close/open a list of discussions.
body → 200202403408
POST
/discussions/idea
Add an idea.
body → 201202
DELETE
/discussions/list
Delete a list of discussions.
body → 202204403408
PATCH
/discussions/merge
Merge discussions.
body → 200202403408
PATCH
/discussions/move
Move a list of discussions.
body → 200202403408
GET
/discussions/muted
Get a list of the current user's muted discussions.
4 params → 200
POST
/discussions/poll
Add a poll.
body → 201202
POST
/discussions/question
Add a discussion.
body → 201202
POST
/discussions/resolve-bulk
Mark all discussions you can triage as resolved.
→ 201
GET
/discussions/search
Search discussions.
7 params → 200
POST
/discussions/split
Split comments out into a discussion.
body → 200202403408
DELETE
/discussions/{id}
Delete a discussion.
2 params → 202204403408
GET
/discussions/{id}
Get a discussion.
3 params → 200
PATCH
/discussions/{id}
Update a discussion.
1 param body → 200202
PUT
/discussions/{id}/bookmark
Bookmark a discussion.
1 param body → 200
PATCH
/discussions/{id}/bump
Bump a discussion higher in the list by updating the DateLastComment field.
1 param → 200404400
PUT
/discussions/{id}/canonical-url
Set custom canonical url for a discussion.
1 param body → 200404400
DELETE
/discussions/{id}/canonical-url
Remove custom canonical url for a discussion.
1 param → 204404
PUT
/discussions/{id}/dismiss
Dismiss an announcement.
1 param body → 200
GET
/discussions/{id}/edit
Get a discussion for editing.
3 params → 200
PATCH
/discussions/{id}/idea
Update idea metadata on a discussion.
1 param body → 200
PUT
/discussions/{id}/mute
1 param body → 200
GET
/discussions/{id}/poll
Get a poll.
2 params → 200
PATCH
/discussions/{id}/poll
Update a poll.
1 param body → 200
GET
/discussions/{id}/quote
3 params → 200
PUT
/discussions/{id}/status
Change a discussion status.
1 param body → 200
GET
/discussions/{id}/status-log
List of status changes for a discussion.
4 params → 200
PUT
/discussions/{id}/tags
Set the tags on a discussion.
1 param body → 200401404
POST
/discussions/{id}/tags
Add tags to a discussion.
1 param body → 200401404
PUT
/discussions/{id}/type
Change a discussion type.
1 param body → 200

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are Discussion (41 properties), DiscussionPost (13 properties), DiscussionGetEdit (12 properties), DiscussionPatch (11 properties). Each schema is shown below with its type and property counts.

StatusFragment
object
Describes a status currently applied to a discussion. Expandable with status and status.log expands.
7 properties 4 required
ReportReasonFragment
object
6 properties 5 required
PostPremoderation
object
4 properties
DiscussionPatch
object
11 properties
TagReference
object
A reference to a tag for assignment to other items.
2 properties
DiscussionGetEdit
object
12 properties 9 required
PostMeta
object
Custom post fields. This is an object keyed by postFieldID.
SrcSet
object
An image's srcset for various sizes.
4 properties
UserFragment
TrackingSlipData
object
Represents a scheduled server-side job.
3 properties
Format
string
The format of the body used to convert it to HTML.
StatusLog
object
6 properties 5 required
ReportMeta
object
7 properties
CategoryFragment
object
3 properties 3 required
PostFragment
object
8 properties 4 required
LongRunnerResult
object
Endpoints will return this if they may time out and require the client to progress the task with additional requests.
2 properties 2 required
RangeExpression
string
Specify a range or CSV of values.
TagFragment
object
A tag that can be applied to content.
4 properties 3 required
LongRunnerProgress
object
Progress of the task.
4 properties 3 required
DiscussionPost
object
13 properties 3 required
Discussion
object
41 properties 18 required
Image
object
An image, pulled from content.
3 properties
DiscussionPermissions
object
Permissions for the current user related to discussions. Applied when expanded..

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vanilla-forums-discussions-api-openapi.yml Raw ↑

Other APIs Vanilla Forums publishes across the network.

Vanilla Forums Addons API
Vanilla Forums AI Processing Preferences API
Vanilla Forums AI Settings API
Vanilla Forums Analytics API
Vanilla Forums Appeals API
Vanilla Forums Assets API
Vanilla Forums Audit Logs API
Vanilla Forums Authenticators API
Vanilla Forums Automation Rules API
Vanilla Forums Calls API
Vanilla Forums Categories API
Vanilla Forums Collections API
Where this information came from

This is an independent, third-party profile of Vanilla Forums Discussions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.