Change Log
Version 2.3
General changed
- All methods are now available under the /2.3/ path, new properties will only be returned if the /2.3/ version of a method is called.
- New types and operations related to the release of Collectives.
- New endpoints related to Articles.
- Flags can now be retracted via API. Note that this changed existing behavior related to posting an existing flag Id to
/flags/add
. See flag addition endpoint for details.
New methods
- /collectives
- /collectives/{slug}
- /collectives/{slug}/questions
- /collectives/{slug}/answers
- /collectives/{slug}/tags
- /collectives/{slug}/users
- /collectives/{slug}/reports
- /collectives/{slug}/reports/add
- /articles
- /articles/{id}
- /articles/{id}/delete
- /articles/{id}/edit
- /articles/{id}/linked
- /articles/{id}/add
New types
Additions to existing types
- user.collectives
- answer.collectives
- post.posted_by_collectives
- shallow_user.account_id
- flag_option.is_retraction
Version 2.2
General changed
- All methods are now available under the /2.2/ path, new properties will only be returned if the /2.2/ version of a method is called.
- Write operations for creating, editing, deleting, voting on, and flagging questions, answers, and comments.
- Improved throttle code with more intentional "burst aware" rate limiting.
New methods
- /answers/{ids}
- /answers/{id}/accept
- /answers/{id}/accept/undo
- /answers/{id}/delete
- /answers/{id}/downvote
- /answers/{id}/downvote/undo
- /answers/{id}/edit
- /answers/{id}/flags/add
- /answers/{id}/flags/options
- /answers/{id}/upvote
- /answers/{id}/upvote/undo
- /comments/{id}/flags/options
- /comments/{id}/flags/add
- /comments/{id}/upvote
- /comments/{id}/upvote/undo
- /me/network-activity
- /me/posts
- /me/top-tags
- /posts/{id}/comments/render
- /questions/{id}/answers/add
- /questions/{id}/answers/render
- /questions/{id}/close/options
- /questions/{id}/delete
- /questions/{id}/downvote
- /questions/{id}/downvote/undo
- /questions/{id}/edit
- /questions/{id}/favorite
- /questions/{id}/favorite/undo
- /questions/{id}/flags/add
- /questions/{id}/flags/options
- /questions/add
- /questions/render
- /questions/unanswered/my-tags
- /questions/{id}/upvote
- /questions/{id}/upvote/undo
- /search/excerpts
- /users/{id}/network-activity
- /users/{ids}/posts
- /users/{ids}/top-tags
New types
Additions to existing types
- answer.accepted
- answer.awarded_bounty_amount
- answer.awarded_bounty_users
- answer.body_markdown
- answer.can_flag
- answer.comment_count
- answer.downvoted
- answer.last_editor
- answer.share_link
- answer.upvoted
- comment.can_flag
- comment.upvoted
- network_user.top_answers
- network_user.top_questions
- post.body_markdown
- post.comment_count
- post.downvoted
- post.last_editor
- post.share_link
- post.title
- post.upvoted
- question.body_markdown
- question.bounty_user
- question.can_close
- question.can_flag
- question.closed_details
- question.comment_count
- question.downvoted
- question.favorited
- question.last_editor
- question.share_link
- question.upvoted
- shallow_user.badge_counts
- tag.synonyms
Deprecated methods
- /users/{id}/write-permissions
- /me/write-permissions
Version 2.1
General changes
- All methods are now available under the /2.1/ path, new properties will only be returned if the /2.1/ version of a method is called.
- Limited support for writing via the API, restricted to comments.
- /users/{ids}/top-answer-tags and users/{ids}/top-question-tags are now vectorized.
write_access
andprivate_info
scopes added to OAuth flows.
New methods
- /comments/{id}/delete
- /comments/{id}/edit
- /me/merges
- /me/notifications
- /me/notifications/unread
- /me/reputation-history
- /me/reputation-history/full
- /me/write-permissions
- /notifications
- /notifications/unread
- /posts/{id}/comments/add
- /search/advanced
- /users/{ids}/merges
- /users/{ids}/reputation-history
- /users/{ids}/reputation-history/full
- /users/{ids}/write-permissions
- /users/{id}/notifications
- /users/{id}/notifications/unread
New types
Additions to existing types
- answer.tags
- comment.body_markdown
- site.high_resolution_icon_url
- post.link
- question.close_vote_count
- question.reopen_vote_count
- question.delete_vote_count
- question.notice
- top_tag.user_id
Version 2.0
General changes
- All API request now go to
api.stackexchange.com
with asite
parameter, rather than per-site endpoints as in V1.x. - All methods found on Stack Auth in V1.x are now found under
api.stackexchange.com
, but do not require asite
parameter. - All method now return a common response wrapper object, which places data in the
items
property. - Throttle and request quota information is now returned as part of the response body, not in headers as in V1.x.
- DEFLATE is available as a response compression option, joining GZIP from V1.x.
callback
is now available for JSONP in addition tojsonp
from V1.x.- All returned fields are now safe to inline in HTML by default, further discussion under the safety topic.
Method changes
- /badges/{ids} now returns badges.
- /badges/{ids}/recipients replaces the old
/badges/{ids}
- /questions/{ids}/comments and /answers/{ids}/comments no longer work for the incorrect post type.
- /revisions/{ids} now takes revision.revision_guid instead of post ids, /posts/{ids}/revisions replaces the V1.x method.
- /users now returns unregistered users in addition to registered users and moderators.
- /info has replaced the
/stats
method from V1.x. - The featured sort is no longer available on /questions, the new /questions/featured method should be used instead.
- /users/{id}/associated now expects account ids to be passed, not association guids. Association guids are deprecated.
General Aadditions
- It is now possible to authenticate Stack Exchange users via OAuth 2.0.
- Filters make it possible to optimize both the response size and request time of queries to the API.
- In conjunction with authentication, a series of per-user throttles are now available in addition to the per-IP ones from V1.x.
- Every method of the form
/users/{ids}*
now has a/me
version, which is the same as calling the/users/{ids}
version with the user id of the passedaccess_token
passed.
New methods
- /badges/recipients
- /badges/{ids}/recipients
- /errors
- /events
- /posts
- /posts/{ids}
- /posts/{ids}/revisions
- /posts/{ids}/suggested-edits
- /suggested-edits
- /suggested-edits/{ids}
- /info
- /questions/featured
- /tags/required
- /tags/moderator-only
- /tags/{tags}/info
- /tags/{tags}/faq
- /tags/{tags}/related
- /users/{ids}/suggested-edits
- /users/moderators/elected
- /users/{id}/inbox
- /users/{id}/inbox/unread
- /access-tokens/{accessTokens}/invalidate
- /access-tokens/{accessTokens}
- /apps/{accessTokens}/de-authenticate
- /filters/create
- /filters/{filters}
- /inbox
- /inbox/unread