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.
Body
PARAM
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
}
} |
ENDPOINTS