Forum Posts

An alias for /forum_posts exists: /fposts

Search Forum Posts

GET https://e621.net/forum_posts.json

Moderator+ Required To search hidden forum posts not created by the authenticated user.

Some posts may be in specific categories that require certain user levels to view.

Query Parameters

Name	Type	Description
search[topic_title_matches]	String	The title of the topic the forum post is in.
search[body_matches]	String	The body of the post.
search[creator_id]	Number	The ID of the creator of the forum post.
search[creator_name]	String	The name of the creator of the forum post.
search[topic_category_id]	Number	The ID of the category the topic containing the forum post is in.
search[topic_id]	Number	The ID of the topic the forum post is in.
search[is_hidden]	Boolean	If the forum post is hidden.
search[id]	Number	See Search Parameters: search[id]
limit	Number	See Search Parameters: limit
page	String	See Search Parameters: page

200: OK Success (Results)

[
  {
    "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
  }
]

200: OK Success (No Results) !!

{
  "forum_posts": []
}

Get Forum Post

GET https://e621.net/forum_posts/{id}.json

Moderator+ Required If the forum post is hidden, and not created by the authenticated user.

Some posts may be in specific categories that require certain user levels to view.

Path Parameters

Name	Type	Description
id*	Number	The ID of the forum post.

200: OK Success

{
  "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
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

Add Warning To Forum Post

POST https://e621.net/forum_posts/{id}/warning.json

Authorization Required

Moderator+ Required

This operation is idempotent.

Path Parameters

Name	Type	Description
id*	Number	The ID of the forum post to add a warning to.

Request Body

Name	Type	Description
record_type*	String	The type of warning to add to the forum post. One of: warning, record, ban, unmark.

200: OK Success

{
  "html": "", // new forum post html contents
  "posts": {}
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

500: Internal Server Error Invalid Warning Type

{
  "success": false,
  "message": "'TYPE' is not a valid warning_type",
  "code": "00000000-0000-0000-0000-000000000000"
}

Hide Forum Post

POST https://e621.net/forum_posts/{id}/hide.json

Authorization Required

Moderator+ Required If the forum post is not yours.

This operation is idempotent.

Path Parameters

Name	Type	Description
id*	Number	The ID of the forum post to hide.

201: Created Success

{
  "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
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

Unhide Forum Post

POST https://e621.net/forum_posts/{id}/unhide.json

Authorization Required

Moderator+ Required

This operation is idempotent.

Path Parameters

Name	Type	Description
id*	Number	The ID of the forum post to unhide.

201: Created Success

{
  "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
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

Create Forum Post

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

Authorization Required

Account must be at least 3 days old.

Some topics may be in specific categories that require certain user levels to reply.

Request Body

Name	Type	Description
forum_post[body]*	String	The body of the forum post.
forum_post[topic_id]*	Number	The ID of the topic to create the forum post in.

201: Created Success

{
  "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
}

403: Forbidden Access Denied

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

422: Unprocessable Entity Account Too New

{
  "errors": {
    "creator": [
      "can not yet perform this action. Account is too new"
    ]
  }
}

422: Unprocessable Entity Invalid Forum Topic

{
  "errors": {
    "topic": [
      "must exist"
    ],
    "base": [
      "Topic ID is invalid"
    ]
  }
}

422: Unprocessable Entity Missing Body

{
  "errors": {
    "body": [
      "can't be blank",
      "is too short (minimum is 1 character"
    ]
  }
}

422: Unprocessable Entity Body Too Long

{
  "errors": {
    "body": [
      "is too long (maximum is 50000 characters)"
    ]
  }
}

422: Unprocessable Entity Topic (Category) Restricted

{
  "errors": {
    "topic": [
      "is restricted",
      "does not allow replies"
    ]
  }
}

Edit Forum Post

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

Authorization Required

Admin+ Required If the forum post is not yours.

Path Parameters

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

Request Body

Name	Type	Description
forum_post[body]	String	The body of the forum post.

204: No Content Success

403: Forbidden Access Denied

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

404: Not Found Not Found

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

422: Unprocessable Entity Blank Body

{
  "errors": {
    "body": [
      "can't be blank",
      "is too short (minimum is 1 character"
    ]
  }
}

422: Unprocessable Entity Body Too Long

{
  "errors": {
    "body": [
      "is too long (maximum is 50000 characters)"
    ]
  }
}

Delete Forum Post

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

Authorization Required

Admin+ Required

204: No Content Success

403: Forbidden Access Denied

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

404: Not Found Not Found

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

Name	Type	Description
id*	Number	The ID of the forum post to vote on.

Request Body

Name	Type	Description
forum_post_vote[score]*	Number	The vote to cast. One of: -1, 0, 1.

201: Created Success

{
  "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"
}

403: Forbidden Access Denied

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

403: Forbidden Account Too New

{
  "success": false,
  "reason": "Access Denied: Creator can not yet perform this action. Account is too new"
}

403: Forbidden Invalid Score

{
  "success": false,
  "reason": "Access Denied: Score is not included in the list"
}

403: Forbidden Cannot Vote On Own Post

{
  "success": false,
  "reason": "Access Denied: You cannot vote on your own requests"
}

404: Not Found Not Found

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

Delete Forum Post Vote

DELETE https://e621.net/forum_posts/{id}/votes.json

Authorization Required

Path Parameters

Name	Type	Description
id*	Number	The ID of the forum post to delete the vote on.

200: OK Success

{}

403: Forbidden Access Denied

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

404: Not Found Not Found

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