Sign in
posts

Update a post

Changed on

Updates a post's tags, sources, rating, parent, or description. The set of accepted fields widens with the requester's level; sending a field above the requester's level is rejected with 403.

tag_string_diff takes precedence over tag_string, and source_diff over source.

When v2=true, the response uses the v2 Post format selected by mode (basic default, extended, or thumbnail). Otherwise the legacy format wrapped in { "post": {...} } is returned.

put/posts/{id}.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/posts/{id}.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Path parameters

idinteger required

The unique ID of the post to update

Query parameters

v2'true'

If "true", the response uses the v2 Post format. Otherwise the legacy format is returned.

mode'basic' | 'extended' | 'thumbnail' | 'thumbnails'

Selects the v2 Post payload shape. Only effective when v2=true. Default basic.

Request body

Response

The post after the update was applied

OR
OR
OR

Changes