Post Sets

Search Post Sets

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

Query Parameters

Name

Type

Description

[
  {
    "created_at": "0000-00-00T00:00:00.000-00:00",
    "creator_id": 0,
    "description": "",
    "id": 0,
    "is_public": false,
    "name": "",
    "post_count": 0,
    "post_ids": [
      0
    ],
    "shortname": "",
    "transfer_on_delete": false,
    "updated_at": "0000-00-00T00:00:00.000-00:00"
  }
]

// See https://github.com/e621ng/e621ng/issues/359
{
  "post_sets": []
}

Get Post Set

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

Moderator+ Required If set is private.

Path Parameters

{
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "description": "",
  "id": 0,
  "is_public": false,
  "name": "",
  "post_count": 0,
  "post_ids": [
    0
  ],
  "shortname": "",
  "transfer_on_delete": false,
  "updated_at": "0000-00-00T00:00:00.000-00:00"
}

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

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

Create Post Set

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

Authorization Required

Janitor+ Required If account is less than 3 days old.

Request Body

{
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "description": "",
  "id": 0,
  "is_public": false,
  "name": "",
  "post_count": 0,
  "post_ids": [
    0
  ],
  "shortname": "",
  "transfer_on_delete": false,
  "updated_at": "0000-00-00T00:00:00.000-00:00"
}

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

{
  "errors": {
    "base": [
      "Can't make a set public until your account is at least three days old"
    ]
  }
}

{
  "errors": {
    "name": [
      "is already taken"
    ]
  }
}

{
  "errors": {
    "shortname": [
      "is already taken"
    ]
  }
}

{
  "errors": {
    "name": [
      "must be between three and one hundred characters long"
    ]
  }
}

{
  "errors": {
    "shortname": [
      "must be between three and fifty characters long"
    ]
  }
}

{
  "errors": {
    "shortname": [
      "must contain at least one lowercase letter or underscore"
    ]
  }
}

{
  "errors": {
    "description": [
      "is too long (maximum is 10000 characters)"
    ]
  }
}

{
  "errors": {
    "base": [
      "You have already created 6 sets in the last hour."
    ]
  }
}

{
  "errors": {
    "base": [
      "You can only create 75 sets."
    ]
  }
}

Edit Post Set

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

Authorization Required

Janitor+ Required If account is less than 3 days old.

Admin+ Required If the set is not yours.

Path Parameters

Request Body

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

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

{
  "errors": {
    "base": [
      "Can't make a set public until your account is at least three days old"
    ]
  }
}

{
  "errors": {
    "name": [
      "is already taken"
    ]
  }
}

{
  "errors": {
    "shortname": [
      "is already taken"
    ]
  }
}

{
  "errors": {
    "name": [
      "must be between three and one hundred characters long"
    ]
  }
}

{
  "errors": {
    "shortname": [
      "must be between three and fifty characters long"
    ]
  }
}

{
  "errors": {
    "shortname": [
      "must contain at least one lowercase letter or underscore"
    ]
  }
}

{
  "errors": {
    "description": [
      "is too long (maximum is 10000 characters)"
    ]
  }
}

Delete Post Set

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

Authorization Required

Admin+ Required If the set isn't yours.

Path Parameters

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

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

Add Posts To Post Set

POST https://e621.net/post_sets/{id}/add_posts.json

Authorization Required

Admin+ Required If the post set isn't owned or maintained by you.

While the limit is 10,000 posts, attempting to add that many posts at once will most likely result in a timeout with status code 524. A request that would take the set over the 10,000 post limit will fail and none of the posts will be added. Invalid IDs are silently ignored. This operation is idempotent.

Path Parameters

Request Body

{
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "description": "",
  "id": 0,
  "is_public": false,
  "name": "",
  "post_count": 0,
  "post_ids": [
    0
  ],
  "shortname": "",
  "transfer_on_delete": false,
  "updated_at": "0000-00-00T00:00:00.000-00:00"
}

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

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

{
  "errors": {
    "base": [
      "Sets can have up to 10,000 posts each"
    ]
  }
}

{
  "success": false,
  "message": "An unexpected error occurred.",
  "code": "00000000-0000-0000-0000-000000000000"
}

Remove Posts From Post Set

POST https://e621.net/post_sets/{id}/remove_posts.json

Authorization Required

Admin+ Required If the post set isn't owned or maintained by you.

Invalid IDs are silently ignored. This operation is idempotent.

Path Parameters

Request Body

{
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "description": "",
  "id": 0,
  "is_public": false,
  "name": "",
  "post_count": 0,
  "post_ids": [
    0
  ],
  "shortname": "",
  "transfer_on_delete": false,
  "updated_at": "0000-00-00T00:00:00.000-00:00"
}

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

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

{
  "success": false,
  "message": "An unexpected error occurred.",
  "code": "00000000-0000-0000-0000-000000000000"
}

Post Sets For Select

GET https://e621.net/post_sets/for_select.json

Authorization Required

undefined

Invalid IDs are silently ignored. This operation is idempotent.

Path Parameters

Request Body

{
  "Owned": [
    "", // name
    0 // id
  ],
  "Maintained": [
    "", // name
    0 // id
  ]
}

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

PreviousPools

Last updated 11 months ago