An alias for /forum_topics
exists: /ftopics
(hide, unhide, mark_all_as_read, subscribe, and ubsuscribe routes are not supported).
Search Forum Topics
GET
https://e621.net/forum_topics.json
Moderator+ Required To search hidden forum topics not created by the authenticated user.
Some topics may be in specific categories that require certain user levels to view.
Query Parameters
[
{
"category_id": 0,
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"is_locked": false,
"is_sticky": false,
"response_count": 0,
"title": "",
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0
}
]
Get Forum Topic
GET
https://e621.net/forum_topics/{id}.json
Moderator+ Required If the forum topic is hidden, and not created by the authenticated user.
Some topics may be in specific categories that require certain user levels to view.
Path Parameters
{
"category_id": 0,
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"is_locked": false,
"is_sticky": false,
"response_count": 0,
"title": "",
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0
}
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
Hide Forum Topic
POST
https://e621.net/forum_topics/{id}/hide.json
Authorization Required
Moderator+ Required If the forum topic is not yours.
This operation is idempotent.
Path Parameters
{
"category_id": 0,
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"is_locked": false,
"is_sticky": false,
"response_count": 0,
"title": "",
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0
}
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
Unhide Forum Topic
POST
https://e621.net/forum_topics/{id}/unhide.json
Authorization Required
Moderator+ Required
This operation is idempotent.
Path Parameters
{
"category_id": 0,
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"is_locked": false,
"is_sticky": false,
"response_count": 0,
"title": "",
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0
}
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
Subscribe To Forum Topic
POST
https://e621.net/forum_topics/{id}/subscribe.json
Authorization Required
Some topics may be in specific categories that require certain user levels to view.
This operation is idempotent.
Path Parameters
{
"category_id": 0,
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"is_locked": false,
"is_sticky": false,
"response_count": 0,
"title": "",
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0
}
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
Unubscribe From Forum Topic
POST
https://e621.net/forum_topics/{id}/subscribe.json
Authorization Required
Some topics may be in specific categories that require certain user levels to view.
This operation is idempotent.
Path Parameters
{
"category_id": 0,
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"is_locked": false,
"is_sticky": false,
"response_count": 0,
"title": "",
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0
}
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
Mark All Forum Topics As Read
POST
https://e621.net/forum_topics/mark_all_as_read.json
Authorization Required
<html><body>You are being <a href="https://e621.net/forum_topics">redirected</a>.</body></html>
Create Forum Topic
POST
https://e621.net/forum_topics.json
Authorization Required
Some topics may be in specific categories that require certain user levels to create topics.
Request Body
{
"body": "",
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"id": 0,
"is_hidden": false,
"topic_id": 0,
"updated_at": "0000-00-00T00:00:00.000-00:00",
"updater_id": 0,
"warning_type": null, // warning, record, ban
"warning_user_id": null
}
{
"success": false,
"reason": "Access Denied"
}
{
"errors": {
"original_post.creator": [
"can not yet perform this action. Account is too new"
]
}
}
{
"errors": {
"original_post": [
"is invalid"
]
}
}
{
"errors": {
"original_post.topic": [
"is restricted",
"does not allow replies"
]
}
}
{
"errors": {
"category": [
"does not allow new topics"
]
}
}
{
"errors": {
"original_post": [
"can't be blank"
]
}
}
{
"success": false,
"message": "An unexpected error occurred.",
"code": "00000000-0000-0000-0000-000000000000"
}
{
"errors": {
"title": [
"is too long (maximum is 250 characters)"
]
}
}
{
"errors": {
"original_post.body": [
"is too long (maximum is 50000 characters)"
]
}
}
Edit Forum Topic
PATCH
https://e621.net/forum_topics/{id}.json
Authorization Required
Admin+ Required If the forum topic is not yours.
Path Parameters
Request Body
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
{
"errors": {
"body": [
"can't be blank",
"is too short (minimum is 1 character"
]
}
}
{
"errors": {
"body": [
"is too long (maximum is 50000 characters)"
]
}
}
Delete Forum Post
DELETE
https://e621.net/forum_posts/{id}.json
Authorization Required
Admin+ Required
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}
Create Forum Post Vote
POST
https://e621.net/forum_posts/{id}/votes.json
Authorization Required
Janitor+ Required If account is less than 3 days old.
Votes can only be added to posts which are the OP of an alias request, implication request, or bulk update request.
Access denied error messages can be combined, separated by a semicolon and space (;
).
Path Parameters
Request Body
{
"created_at": "0000-00-00T00:00:00.000-00:00",
"creator_id": 0,
"creator_name": "",
"forum_post_id": 0,
"id": 0,
"score": 0, // 1, 0, -1
"updated_at": "0000-00-00T00:00:00.000-00:00"
}
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "Access Denied: Creator can not yet perform this action. Account is too new"
}
{
"success": false,
"reason": "Access Denied: Score is not included in the list"
}
{
"success": false,
"reason": "Access Denied: You cannot vote on your own requests"
}
{
"success": false,
"reason": "not found"
}
Delete Forum Post Vote
DELETE
https://e621.net/forum_posts/{id}/votes.json
Authorization Required
Path Parameters
{
"success": false,
"reason": "Access Denied"
}
{
"success": false,
"reason": "not found"
}