Changeset

Retrieve Completed Changeset status

GET

Retrieve a Changeset by its unique ID. This endpoint waits for the Changeset to complete its processing prior to returning a result.

A Changeset is an individual edit that has been made to a project. Since multiple users can edit a project at the same time, individual Changesets are applied in a sequential fashion. If a Changeset causes a conflict or cannot be applied, it will be rejected. You can examine a Changeset to determine its conflict resolution status.

When checking the status of a Changeset, you can call either RetrieveChangeset or RetrieveCompletedChangeset. Using RetrieveChangeset will give you the immediate status of the Changeset. Using RetrieveCompletedChangeset will delay the response until the Changeset has finished processing.

Although most Changesets complete instantly, some Changesets may need additional time to complete. If the Changeset cannot be processed within a reasonable length of time, this API call may fail. If this API fails, it will return a status error indicating the Changeset is still being processed.

Path parameters

changeSetIdstringRequired
The unique ID number of the Changeset to retrieve

Response

This endpoint returns an object
error
objectOptional
If the API call failed, this will contain information about the error that occurred.
success
booleanOptional
True if the API call succeeded; false otherwise.
hasError
booleanOptional
True if the API call failed.
statusCode
enumOptional
The HTTP code of the response.
data
objectOptional
A ProjectChange is an individual edit that has been made to a project. Since multiple users can edit a project at the same time, individual ProjectChanges are applied in a sequential fashion. If a ProjectChange causes a conflict or cannot be applied, it will be rejected. You can examine a ProjectChange to determine its conflict resolution status.
GET
1curl /api/data/changesets/changeSetId/poll \
2 -H "Authorization: Bearer <token>"
200
Retrieved
1{
2 "error": {
3 "technicalError": "technicalError",
4 "additionalErrors": [
5 "additionalErrors"
6 ],
7 "message": "message"
8 },
9 "success": true,
10 "hasError": true,
11 "statusCode": "Continue",
12 "data": {
13 "id": "id",
14 "success": true,
15 "state": "NotStarted"
16 }
17}