Retrieve the details of changed Work Items

This REST API will return the details of the Work Items that have changed since the last time the API was called, based on the rowver value (if supplied), up to limit Work Items (if supplied).

URL

GET /up/v5/bns/win?rowver=${rowver}&limit=${limit}

HTTP Request Body

This request does not require a request body.

HTTP Response

Success

On success, an HTTP response code of 200 will be returned, and the response body will contain a JSON object, consisting of:

A rowver field, containing the ${rowver} value to be used in the next call to the API.
A row field, containing an array of Work Item Notification Objects.

For example:

JSON Format

{
    "rowver": 12345,
    "rows": [
		{
			// Work Item Notification Object
		},
		{
			// Work Item Notification Object
		},
		...
    ]
}

Error

Otherwise, on error, the API will:

Return an HTTP response code of 400, if the request was invalid;
Return an HTTP response code of 401, if the request was not authorized; or
Return an HTTP response code of 500, if something else went wrong.

Both HTTP 400 and 500 responses will contain a REST Integration Standard Response Object with appropriate values for the Code and/or Message fields, describing the error, in the response body.

Browser not supported