Get all elements and folders
GET https://api.getpostman.com/network/private
Gets information about the folders and elements added to your [Private API Network] Elements are APIs, collections, and workspaces.
Note:
The limit
and offset
parameters are separately applied to elements and folders. For example, if you query a limit
value of 10
and an offset
value 0
, the endpoint returns 10 elements and 10 folders for a total of 20 items. The totalCount
property in the meta
response is the total count of both elements and folders.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
since | string | Optional. Return only elements updated at and after this time, in ISO 8601 UTC format. | |
until | string | Optional. Return only elements updated at and before this time, in ISO 8601 UTC format. | |
addedBy | string | Optional. Return only elements published by the given user ID. | |
name | string | Optional. Return only elements whose name includes the given value. Matching is not case-sensitive. | |
summary | string | Optional. Return only elements whose summary includes the given value. Matching is not case-sensitive. | |
description | string | Optional. Return only elements whose description includes the given value. Matching is not case-sensitive. | |
sort | string | Optional. Sort the results by the given value. One of: |
createdAt
updatedAt
If you use this query parameter, you must also use the direction
parameter. |
| direction
| string | | Optional. Sort in ascending (asc
) or descending (desc
) order. Matching is not case-sensitive. If you use this query parameter, you must also use the sort
parameter. |
| createdBy
| string | | Optional. Return only the elements created by the given user ID. |
| offset
| string | | Optional. The zero-based offset of the first item to return. This value defaults to 0
. |
| limit
| string | | Optional. The maximum number of elements to return. If the value exceeds the maximum value of 1000
, then the system uses the 1000
value. |
| parentFolderId
| string | | Optional. Return the folders and elements in a specific folder in the Private API Network. If this value is 0
, then the endpoint only returns the root folder's elements. |
| type
| string | | Optional. Filter by the element type. One of:
folder
workspace
collection
api
|
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-API-Key | null |
RESPONSES
status: OK
{"elements":[{"addedAt":"2021-11-29T06:31:24.000Z","addedBy":12345678,"createdBy":12345678,"createdAt":"2020-06-01T08:32:31.000Z","updatedBy":12345678,"updatedAt":"2021-11-29T06:31:24.000Z","type":"api","id":"5360b75f-447e-467c-9299-12fd6c92450d","parentFolderId":1,"name":"Billing API","summary":"The payments and account services API.","description":null,"href":"https://api.getpostman.com/apis/5360b75f-447e-467c-9299-12fd6c92450d"}],"folders":[{"id":1,"parentFolderId":0,"updatedAt":"2021-11-29T06:31:24.000Z","updatedBy":12345678,"createdBy":12345678,"createdAt":"2020-06-01T08:32:31.000Z","name":"Billing","description":"The Billing API.","type":"folder"}],"meta":{"limit":1000,"offset":0,"totalCount":2}}