Forum Categories

These are very poorly documented as the routes are admin only, typically only respond with html (unless an error shows up), and are extremely unpredictable. They have only been included to completely

GET /forum_categories does not support JSON

Create Forum Category

POST https://e621.net/forum_categories.json

Authorization Required

Admin+ Required

Due to this being admin only and typically ui based, there are no standard responses for errors or otherwise.

Request Body

Name	Type	Description
forum_category[name]*	String	The name of the category.
forum_category[description]	String	The description of the category.
forum_category[can_create]	Number	The level users must be to create topics in the category.
forum_category[can_reply]	Number	The level users must be to reply to topics in the category.
forum_category[can_view]	Number	The level users must be to view topics in the category.
forum_category[cat_order]	Number	The sorting order of the category.

Name

Type

Description

forum_category[name]*

String

The name of the category.

forum_category[description]

String

The description of the category.

forum_category[can_create]

Number

The level users must be to create topics in the category.

forum_category[can_reply]

Number

The level users must be to reply to topics in the category.

forum_category[can_view]

Number

The level users must be to view topics in the category.

forum_category[cat_order]

Number

The sorting order of the category.

// This will be returned regardless if a category was actually created (unless the controller or database returns an error)
<html><body>You are being <a href="https://e621.net/forum_categories">redirected</a>.</body></html>

{
  "success": false,
  "message": "PG::NotNullViolation: ERROR:  null value in column \"name\" violates not-null constraint\nDETAIL:  Failing row contains (0, null, , null, 0, 0, 0).\n",
  "code": "00000000-0000-0000-0000-000000000000"
}

{
  "success": false,
  "message": "param is missing or the value is empty: forum_category\nDid you mean?  format\n               controller\n               action",
  "code": null
}

{
  "success": false,
  "reason": "Access Denied"
}

Edit Forum Category

PATCH https://e621.net/forum_categories/{id}.json

Authorization Required

Admin+ Required

Due to this being admin only and typically ui based, there are no standard responses for errors or otherwise.

Path Parameters

Name	Type	Description
id*	Number	The ID of the category to edit.

Name

Type

Description

id*

Number

The ID of the category to edit.

Request Body

Name	Type	Description
forum_category[name]	String	The name of the category.
forum_category[description]	String	The description of the category.
forum_category[can_create]	Number	The level users must be to create topics in the category.
forum_category[can_reply]	Number	The level users must be to reply to topics in the category.
forum_category[can_view]	Number	The level users must be to view topics in the category.
forum_category[cat_order]	Number	The sorting order of the category.

Name

Type

Description

forum_category[name]

String

The name of the category.

forum_category[description]

String

The description of the category.

forum_category[can_create]

Number

The level users must be to create topics in the category.

forum_category[can_reply]

Number

The level users must be to reply to topics in the category.

forum_category[can_view]

Number

The level users must be to view topics in the category.

forum_category[cat_order]

Number

The sorting order of the category.

// This will be returned regardless of anything being changed (unless the controller or database returns an error)
<html><body>You are being <a href="https://e621.net/forum_categories">redirected</a>.</body></html>

{
  "success": false,
  "reason": "Access Denied"
}

{
  "success": false,
  "reason": "not found"
}

Delete Forum Category

DELETE https://e621.net/forum_categories/{id}.json

Authorization Required

Admin+ Required

As far as I can tell, there is no way to use this from the ui, so forum categories are not meant to be deleted.

This route does not support json, and as such will return a 406 Unacceptable error. The category will still be deleted.

Path Parameters

Name	Type	Description
id*	Number	The ID of the category to delete.

Name

Type

Description

id*

Number

The ID of the category to delete.

{
  "success": false,
  "reason": "Access Denied"
}

{
  "success": false,
  "reason": "not found"
}

PreviousForums NextForum Posts

Last updated 4 months ago