Jump to content

REST API Documentation

/forums/forums


Create a forum

This endpoint is only available for requests made using an API Key or the Client Credentials Grant Type, not using an OAuth Access Token for a particular member.


Parameters

Name Type Description
Required title string The forum title
description string The forum description
type string normal|qa|redirect|category
parent int|null The ID number of the parent the forum should be created in. NULL for root.
password string Forum password
theme int Theme to use as an override
sitemap_priority int 1-9 1 highest priority
min_content int The minimum amount of posts to be able to view
can_see_others int 0|1 Users can see topics posted by other users?
permissions object An object with the keys as permission options (view, read, add, reply, attachments) and values as permissions to use (which may be * to grant access to all groups, or an array of group IDs to permit access to)
redirect_url string If creating a redirect forum, the URL to redirect to.

Exceptions

Code Message Description
1F363/2 NO_TITLE A title for the forum must be supplied
1F363/3 NO_REDIRECT_URL No redirect URL supplied.
1F363/4 INVALID_TYPE Invalid type of forum.

Response

Name Type Description
id int ID number
name string Forum name
path string Forum name including parents (e.g. "Example Category > Example Forum")
type string The type of forum: "discussions", "questions", "category", or "redirect"
topics int Number of topics in forum
url string URL
parentId int|null Parent Node ID
permissions object|null Node permissions
×
×
  • Create New...