Get revisions for a REST API definition

get/restApiDefinitions/{restApiDefinitionId}/revisions

Retrieves a list of all revisions that exist for a REST API definition.

Request Samples

Response Samples

1{
2  "links": [
3    {
4      "method": "GET",
5      "rel": "collection",
6      "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions",
7      "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions",
8      "type": "application/vnd.sas.collection"
9    },
10    {
11      "method": "GET",
12      "rel": "self",
13      "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions?sortBy=creationTimeStamp:descending&start=1&limit=1",
14      "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions?sortBy=creationTimeStamp:descending&start=1&limit=1",
15      "type": "application/vnd.sas.collection",
16      "itemType": "application/vnd.sas.summary"
17    },
18    {
19      "method": "POST",
20      "rel": "create",
21      "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions",
22      "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions",
23      "type": "application/vnd.sas.decision.rest.api.definition",
24      "responseType": "application/vnd.sas.decision.rest.api.definition"
25    },
26    {
27      "method": "GET",
28      "rel": "first",
29      "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions?sortBy=creationTimeStamp:descending&start=0&limit=1",
30      "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions?sortBy=creationTimeStamp:descending&start=0&limit=1",
31      "type": "application/vnd.sas.collection",
32      "itemType": "application/vnd.sas.summary"
33    },
34    {
35      "method": "GET",
36      "rel": "next",
37      "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions?sortBy=creationTimeStamp:descending&start=2&limit=1",
38      "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions?sortBy=creationTimeStamp:descending&start=2&limit=1",
39      "type": "application/vnd.sas.collection",
40      "itemType": "application/vnd.sas.summary"
41    }
42  ],
43  "name": "apiDefinitionRevisions",
44  "accept": "application/vnd.sas.summary",
45  "start": 0,
46  "items": [
47    {
48      "creationTimeStamp": "2023-01-15T11:00:00.000Z",
49      "modifiedTimeStamp": "2023-01-15T11:00:00.001Z",
50      "createdBy": "sasdemo",
51      "modifiedBy": "sasdemo",
52      "id": "e5f6a7b8-c9d0-1234-ef01-23456789abcd",
53      "type": "decisionRESTAPIDefinition",
54      "name": "ExampleAPI",
55      "links": [
56        {
57          "method": "GET",
58          "rel": "up",
59          "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions",
60          "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions",
61          "type": "application/vnd.sas.collection"
62        },
63        {
64          "method": "GET",
65          "rel": "self",
66          "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions/e5f6a7b8-c9d0-1234-ef01-23456789abcd",
67          "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions/e5f6a7b8-c9d0-1234-ef01-23456789abcd",
68          "type": "application/vnd.sas.decision.rest.api.definition"
69        },
70        {
71          "method": "DELETE",
72          "rel": "delete",
73          "href": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions/e5f6a7b8-c9d0-1234-ef01-23456789abcd",
74          "uri": "/decisions/restApiDefinitions/c3d4e5f6-a7b8-9012-cdef-012345678901/revisions/e5f6a7b8-c9d0-1234-ef01-23456789abcd"
75        }
76      ]
77    }
78  ]
79}

Path Parameters

NameTypeRequiredDescription
restApiDefinitionId
string
true

The identifier for the REST API definition.

Query Parameters

NameTypeRequiredDescription
filter
string<filter-criteria>
false

The criteria for filtering the revisions for a REST API definition. See Filtering in REST APIs. The following properties support filtering:

  • createdBy
  • modifiedBy
  • creationTimeStamp
  • modifiedTimeStamp
  • id
  • name
  • description
  • majorRevision
  • minorRevision
  • signature.name
  • signature.description
  • signature.dataType
  • signature.length
  • signature.direction
limit
integer
false

The maximum number of items to return on this page of results. The actual number of returned items might be less if the collection has been exhausted. The default value is '10'.

sortBy
string<sort-criteria>
false

The criteria for sorting the revisions for a REST API definition. See Sorting in REST APIs. The following properties support sorting:

  • createdBy
  • modifiedBy
  • creationTimeStamp
  • modifiedTimeStamp
  • id
  • name
  • description
  • majorRevision
  • minorRevision
Default:
creationTimeStamp:descending
start
integer
false

The starting index for the first item on a page. The index is 0-based. The default value is '0'.

Header Parameters

NameTypeRequiredDescription
Accept-Item
string<media-type>
false

The desired item representation.

Allowed values:
application/vnd.sas.decision.rest.api.definition+jsonapplication/vnd.sas.summary+jsonapplication/vnd.sas.dcm.summary+json
Default:
application/vnd.sas.summary+json

Responses

StatusMeaningDescription
200OK

The request succeeded.

HeadersSchema
404Not Found

No REST API definition exists at the requested path.

HeadersSchema