Add a workspace

POST

/network/private

Publishes a workspace in your team’s Private API Network.

Publishes a workspace in your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).

Authentication

x-api-keystring

API Key authentication via header

Request

This endpoint expects an object.

workspaceobjectRequired

Response

Created

addedAtdatetimeOptional

The date and time at which the element was added.

addedByintegerOptional

The user who added the element.

createdByintegerOptional

The user who created the element.

createdAtdatetimeOptional

The date and time at which the element was created.

updatedByintegerOptional

The user who last updated the element.

updatedAtdatetimeOptional

The date and time at which the element was last updated.

typeenumOptional

The workspace element.

idstringOptional

The element's ID

namestringOptional

The element's name.

summarystring or nullOptional

The element's summary.

descriptionstring or nullOptional

The element's description.

hrefstringOptionalformat: "url"

The element's Postman URL.

parentFolderIdinteger or nullOptionalDeprecated

This property is deprecated.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.postman.com/network/private \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"workspace": {
>	"id": "1f0df51a-8658-4ee8-a2a1-d2567dfa09a9"
>	}
>	}'

1	{
2	"addedAt": "2024-12-07T17:59:23.000Z",
3	"addedBy": 12345678,
4	"createdBy": 12345678,
5	"createdAt": "2024-12-07T17:59:23.000Z",
6	"updatedBy": 12345678,
7	"updatedAt": "2024-12-07T17:59:23.000Z",
8	"type": "workspace",
9	"id": "1f0df51a-8658-4ee8-a2a1-d2567dfa09a9",
10	"name": "Billing Team Workspace",
11	"summary": "The Billing team's workspace.",
12	"description": null,
13	"href": "https://api.postman.com/workspaces/1f0df51a-8658-4ee8-a2a1-d2567dfa09a9",
14	"parentFolderId": null
15	}