Use this call to query a paginated registry of all revision entries created inside a target model.
Note: You must be a Workspace Administrator for both the target and source model workspaces. Additionally, ensure you have access privileges to both models.
Method and endpoint
/models/{modelId}/alm/revisions
Parameters
| Path parameter | Details |
modelId | The unique ID of the model with the revisions. |
Optional Query Parameters
| Query parameters | Type | Details |
appliedAfter | Date format is YYYY-MM-DD | Retrieve the revisions made after a specified date. The date must be earlier than appliedBefore |
appliedBefore | Date format is YYYY-MM-DD | Retrieve the revisions before a specified date. The date must be later than in appliedAfter |
sort | String | Retrieve revisions sorted in dictionary order, ascending or descending, by the specified property. For example, -name sorts the revisions by their names in descending order. |
limit | Integer | Retrieves the specified number of revisions only. |
offset | Integer | Retrieves revisions starting from the specified value. |
Curl example
curl -X GET 'https://api.anaplan.com/2/0/models/{modelId}/alm/revisions' \
-H 'Authorization: AnaplanAuthToken {anaplan_auth_token}'
Response
For a successful request you receive a 200 OK HTTP status with a response body that contains the list of revisions. A list only displays if there were revisions.
{
"meta": {
"paging": {
"currentPageSize": 1,
"offset": 0,
"totalSize": 1
},
"schema": "https://api.anaplan.com/2/0/objects/revision"
},
"status": {
"code": 200,
"message": "Success"
},
"revisions": [
{
"id": "1B9A346A6CE14318925862FE85080068",
"name": "First Revision",
"createdOn": "2021-04-29T12:22:16Z",
"createdBy": "8a80db9362f64cad0162fa0ab3fe0001",
"creationMethod": "User added revision"
}
]
}
Review the ALM API troubleshooting guide to resolve any error responses from API calls.