Get all versions

Deprecated

GET

/apis/:apiId/versions

GET

/apis/:apiId/versions

$ curl https://api.getpostman.com/apis/90ca9f5a-c4c4-11ed-afa1-0242ac120002/versions \
>      -H "Accept: application/vnd.api.v10+json" \
>      -H "x-api-key: <apiKey>"

1 {
2   "meta": {
3     "limit": 2,
4     "total": 1000,
5     "nextCursor": "VGh1IE1hciAxNiAyMDIzIDE3OjIxOjUzIEdNVCswMDAwIChDb29yZGluYXRlZCBVbml2ZXJzYWwgVGltZSk="
6   },
7   "versions": [
8     {
9       "id": "07d940bf-40fc-4acd-a11e-be6769894af0",
10       "name": "Release 2.0",
11       "createdAt": "2022-06-09T14:48:45.000Z",
12       "updatedAt": "2022-06-09T19:50:49.000Z",
13       "releaseNotes": "This is the second release of the Test API."
14     },
15     {
16       "id": "3563baaa-07a2-46ed-9fd2-0e8a3c5f7ec2",
17       "name": "Release 1.0",
18       "createdAt": "2022-06-09T14:48:45.000Z",
19       "updatedAt": "2022-06-09T19:50:49.000Z",
20       "releaseNotes": "This is the first release of the Test API. For more information, read the documentation."
21     }
22   ]
23 }

Gets all the published versions of an API.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

apiIdstringRequired

The API's ID.

Query parameters

cursorstringOptional

The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter.

limitintegerOptionalDefaults to 10

The maximum number of rows to return in the response.

Response

Successful Response

metaobject

The response's meta information for paginated results.

versionslist of objects

A list of the API's versions.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors