Sign in
post_versions

Get a list of post versions

Changed on

Returns a list of post versions based on search criteria.

get/post_versions.json

Request

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

Query parameters

pageinteger

The page number for pagination

limitinteger

The number of post versions to retrieve per page

search[updater_name]string

Filter post versions by the updater's username

search[post_id]integer

Filter post versions by post ID

search[reason]string

Filter post versions by the reason for the update

search[description]string

Filter post versions by description

search[description_changed]boolean

Filter post versions by whether the description was changed

search[rating_changed]'any' | 's' | 'q' | 'e'

Filter post versions by whether the rating was changed

search[rating]'s' | 'q' | 'e'

The rating of the post (e.g., safe, questionable, explicit)

Filter post versions by rating

search[parent_id]integer

Filter post versions by parent post ID

search[parent_id_changed]boolean

Filter post versions by whether the parent ID was changed

search[tags]string

Filter post versions by tags

search[tags_added]string

Filter post versions by tags added

search[tags_removed]string

Filter post versions by tags removed

search[locked_tags]string

Filter post versions by locked tags

search[locked_tags_added]string

Filter post versions by locked tags added

search[locked_tags_removed]string

Filter post versions by locked tags removed

search[source_changed]boolean

Filter post versions by whether the source was changed

search[uploads]'only' | 'included' | 'excluded'

Filter post versions by uploads status

search[created_at]string

Filter post versions by creation date

search[updated_at]string

Filter post versions by last update date

Response

A list of post versions matching the search criteria

idinteger required

The unique ID of the post version

post_idinteger required

The ID of the associated post

tagsstring

The tags associated with the post version

updater_idinteger

The ID of the user who updated the post

updated_atstring date-time required

The timestamp when the post version was updated

rating's' | 'q' | 'e'

The rating of the post (e.g., safe, questionable, explicit)

parent_idinteger nullable

The ID of the parent post, if applicable

sourcestring

The source URL associated with the post version

descriptionstring

The description of the post version

reasonstring nullable

The reason for the update, if applicable

locked_tagsstring nullable

The locked tags associated with the post version

added_tagsstring[]

An array of tags added in this version

removed_tagsstring[]

An array of tags removed in this version

added_locked_tagsstring[]

An array of locked tags added in this version

removed_locked_tagsstring[]

An array of locked tags removed in this version

rating_changedboolean

Whether the rating was changed in this version

parent_changedboolean

Whether the parent ID was changed in this version

source_changedboolean

Whether the source was changed in this version

description_changedboolean

Whether the description was changed in this version

versioninteger required

The version number of the post

updater_namestring

The username of the user who updated the post version

is_hiddenboolean required

Whether this version is hidden

Changes

  • 7eb984be63caRevision changes
    • ▲

      the response property / became optional for the status

    • ▲

      the response property / became optional for the status

    • ▲

      the response property / became optional for the status

    • ▲

      the response property / became optional for the status

    • ▲

      the response property / became optional for the status

    • ▲

      the response property / became optional for the status

    • ▲

      the response property / became optional for the status

    • ○

      the response property / became required for the status

  • d1d05ce5fa8fRevision changes
    • ●

      removed the optional property / from the response with the status

    • ●

      removed the optional property / from the response with the status

    • ●

      removed the optional property / from the response with the status

    • ○

      added the optional property / to the response with the status