Table of Contents

• 1. Record field format
• 2. Associated attributes
• 3. Nomenclature
• 4. Index
• 5. See also

The following includes the details of how to interface with the post version records through the API.

Record field format

Name	Type	Details
id	integer	>0
post_id	integer	>0
tags	string	space delineated, tag format
added_tags	array	string, tag format
removed_tags	array	string, tag format
rating	string	[g, s, q, e]
parent_id	integer	>0 or null
source	string
rating_changed	boolean
parent_changed	boolean
source_changed	boolean
version	integer	>0
updater_id	integer	>0
created_at	timestamp
updated_at	timestamp
updater_addr_ip	inet	Limited to Moderator+

Associated attributes

Name	Type	Number	Availability	Details
post	post	single	required
updater	user	single	required

Nomenclature

• Plural form: "post_versions"
• Used in the URL pathname
• Singular form: "post_version"
• Unused
• Version of: API:Posts

Index

HTTP Method	GET or POST [1]
Base URL	/post_versions.json
Type	read request
Description	The default order is ID descending.

Search attributes

All of the following are standard attributes with all of their available formats and qualifiers.

• Number syntax
• id
• post_id
• parent_id
• updater_id
• version
• created_at
• updated_at
• Text syntax
• tags
• rating
• source
• Boolean syntax
• rating_changed
• parent_changed
• source_changed
• Array syntax
• added_tags
• removed_tags

Special search parameters

• changed_tags - Search where all tags must be either an added tag or removed tag
• The list of tags is space-delineated
• all_changed_tags - The same as changed_tags
• changed_tags - Search where at least one tag must be either an added tag or removed tag
• The list of tags is space-delineated
• tag_matches - Case-insensitive search of the tag string with first tag from the input
• If asterisks ( * ) are missing from the input, it adds an asterisk to either side of the tag
• updater_name - Searches by updater name instead of updater ID
• is_new - Boolean syntax
• Shorthand search for version=1 or version=>1

See also

[1] Help:API read requests

• Help:Number syntax
• Help:Text syntax
• Help:Boolean syntax
• Help:Array syntax
• Help:Common URL Parameters
• Help:API

View wiki