For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportContact salesStart free trial
  • Getting started
    • Overview
    • Authentication
    • Querying tutorial
    • OData Integrations
    • Work Breakdown Structure
    • Software Development Kits
    • API Patch Notes
    • FAQ
    • Terms of use
  • API Reference
      • GETRetrieve Changeset status
      • GETRetrieve Completed Changeset status
LogoLogo
SupportContact salesStart free trial
API ReferenceChangeset

Retrieve Completed Changeset status

GET
https://api.projectmanager.com/api/data/changesets/:changeSetId/poll
GET
/api/data/changesets/:changeSetId/poll
$curl https://api.projectmanager.com/api/data/changesets/changeSetId/poll \
>     -H "Authorization: Bearer <token>"
200Retrieved
1{
2  "error": {
3    "technicalError": "string",
4    "additionalErrors": [
5      "string"
6    ],
7    "validationErrors": {},
8    "message": "string"
9  },
10  "success": true,
11  "hasError": true,
12  "statusCode": "Continue",
13  "data": {
14    "id": "string",
15    "success": true,
16    "state": "NotStarted"
17  }
18}
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.
Was this page helpful?
Previous

Retrieves a list of all countries.

Next
Built with
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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

changeSetIdstringRequiredformat: "uuid"
The unique ID number of the Changeset to retrieve

Headers

x-integration-namestringOptional
The name of the calling system passed along as a header parameter

Response

Success
errorobject or null
If the API call failed, this will contain information about the error that occurred.
successbooleanRead-only

True if the API call succeeded; false otherwise.

hasErrorbooleanRead-only
True if the API call failed.
statusCodeenum
The HTTP code of the response.
dataobject
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.