Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

postman-restapi

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

postman-restapi

The Postman API enables you to programmatically access data stored in your Postman account.

  • 1.0.1
  • PyPI
  • Socket score

Maintainers
1

PostmanRestapi Python SDK 1.0.0

Welcome to the PostmanRestapi SDK documentation. This guide will help you get started with integrating and using the PostmanRestapi SDK in your project.

Versions

  • API version: 1.0
  • SDK version: 1.0.0

About the API

The Postman API enables you to programmatically access data stored in your Postman account.

Table of Contents

  • Setup & Configuration
  • Authentication
  • Using Union Types
  • Services
  • Models
  • License

Setup & Configuration

Supported Language Versions

This SDK is compatible with the following versions: Python >= 3.7

Installation

To get started with the SDK, we recommend installing using pip:

pip install postman-restapi

Authentication

API Key Authentication

The PostmanRestapi API uses API keys as a form of authentication. An API key is a unique identifier used to authenticate a user, developer, or a program that is calling the API.

Setting the API key

When you initialize the SDK, you can set the API key as follows:

PostmanRestapi(
    api_key="YOUR_API_KEY",
    api_key_header="YOUR_API_KEY_HEADER"
)

If you need to set or update the API key after initializing the SDK, you can use:

sdk.set_api_key("YOUR_API_KEY", "YOUR_API_KEY_HEADER")

Using Union Types

Union types allow you to specify that a variable can have more than one type. This is particularly useful when a function can accept multiple types of inputs. The Union type hint is used for this purpose.

Example Function with Union Types

You can call service method with an instance of TypeA, TypeB, or a dictionary that can be converted to an instance of either type.

# Model Definition
ParamType = Union[TypeA, TypeB]

# Service Method
def service_method(param: ParamType):
...

## Usage
type_a = TypeA(key="value")
type_b = TypeB(key="value")

sdk.service.service_method(type_a)
sdk.service.service_method(type_b)
sdk.service.service_method({"key": "value"})

You cannot create an instance of a Union type itself. Instead, pass an instance of one of the types in the Union, or a dictionary that can be converted to one of those types.

Services

The SDK provides various services to interact with the API.

Below is a list of all available services with links to their detailed documentation:
Name
BillingService
ApiService
TagsService
AuditLogsService
CollectionsService
CollectionItemsService
CollectionFoldersService
CollectionRequestsService
CollectionResponsesService
SecretScannerService
EnvironmentsService
ImportService
UserService
MocksService
MonitorsService
PrivateApiNetworkService
PullRequestsService
ApiSecurityService
ScimService
WebhooksService
WorkspacesService

Models

The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.

Below is a list of all available models with links to their detailed documentation:
NameDescription
InvoicesAccountInfoInformation about the account.
GetAccountInvoices
GetAccountInvoicesStatus
GetApisInformation about the API schema.
Accept
CreateApiRequestInformation about the API.
CreateApiOkResponseThe API's base data schema.
GetApi
GetApiInclude
UpdateApiRequestInformation about the API.
UpdateApiOkResponseInformation about the API.
AddApiCollectionRequest
AddApiCollectionOkResponse
SyncCollectionWithSchema
CommentResponse
CommentCreateUpdateInformation about the comment.
CommentCreatedUpdated
CreateApiSchemaRequestInformation about the API schema.
CreateApiSchemaOkResponseInformation about the created API schema.
GetApiSchema
GetApiSchemaFilesInformation about the schema files and its meta information.
GetApiSchemaFileContentsInformation about the schema file.
CreateUpdateApiSchemaFileRequestInformation about schema file.
CreateUpdateApiSchemaFileOkResponseInformation about the schema file.
GetStatusOfAnAsyncTask
GetApiVersionsInformation about the API's versions.
CreateApiVersionRequest
CreateApiVersionAcceptedResponse
GetApiVersion
UpdateApiVersionRequestInformation about the API version.
UpdateApiVersionOkResponse
TagGetPut
TagUpdateTags
GetTaggedEntities
AscDescDefaultDesc
GetTaggedEntitiesEntityType
GetAuditLogs
GetCollections
CollectionsCreateCollectionRequest
CreateCollectionOkResponse
CreateCollectionForkRequest
CreateCollectionForkOkResponse
MergeCollectionForkRequest
MergeCollectionForkOkResponse
GetCollection
GetCollectionModel
PutCollectionRequest
PutCollectionOkResponse
PatchCollectionRequest
PatchCollectionOkResponse
DeleteCollection
GetCollectionsForkedByUser
AscDesc
GetCollectionForks
PullCollectionChanges
GetCollectionPullRequests
PullRequestCreateInformation about the pull request.
PullRequestCreated
GetCollectionRolesInformation about the collection's roles.
UpdateCollectionRoles
GetSourceCollectionStatus
TransformCollectionToOpenApi
Format
TransferCollectionItems
TransferCollectionItems200Error
CreateCollectionFolder
CreateCollectionRequestOkResponse
CreateCollectionResponse
GetCollectionFolder
UpdateCollectionFolder
DeleteCollectionFolder
GetCollectionRequest
UpdateCollectionRequest
DeleteCollectionRequest
GetCollectionResponse
UpdateCollectionResponse
DeleteCollectionResponse
DetectedSecretsQueriesRequest
DetectedSecretsQueriesOkResponse
UpdateDetectedSecretResolutionsRequest
UpdateDetectedSecretResolutionsOkResponse
GetSecretsLocations
GetSecretTypes
GetEnvironments
CreateEnvironmentRequest
CreateEnvironmentOkResponse
GetEnvironment
UpdateEnvironmentRequest
UpdateEnvironmentOkResponse
DeleteEnvironment
GetEnvironmentForks
GetEnvironmentForksSort
ForkEnvironmentRequest
ForkEnvironmentOkResponse
MergeEnvironmentForkRequest
MergeEnvironmentForkOkResponse
PullEnvironmentRequest
PullEnvironmentOkResponse
ImportExportFile
ImportOpenApiDefinitionOkResponse
GetAuthenticatedUser
GetMocks
CreateMock
MockCreateUpdate
GetMock
UpdateMock
DeleteMock
GetMockCallLogs
GetMockCallLogsSort
PublishMock
UnpublishMock
GetMockServerResponsesInformation about the server response.
CreateMockServerResponse
UpdateMockServerResponse
DeleteMockServerResponseInformation about the deleted server response.
GetMonitors
CreateMonitorRequest
CreateMonitorOkResponse
GetMonitor
UpdateMonitorRequest
UpdateMonitorOkResponse
DeleteMonitor
RunMonitor
GetPanElementsAndFolders
GetAllElementsAndFoldersSort
GetAllElementsAndFoldersType
PostPanElementOrFolderRequest
UpdatePanElementOrFolderRequest
UpdatePanElementOrFolderElementType
DeletePanElementOrFolder
GetAllPanAddElementRequests
GetAllPanAddElementRequestsStatus
PrivateApiNetworkRespondPanElementAddRequestRequest_1
RespondPanElementAddRequestOkResponse
PullRequestGet
PullRequestUpdate
PullRequestUpdated
SchemaSecurityValidationRequest
SchemaSecurityValidationOkResponse
GetScimGroupResources
CreateScimGroupRequest
CreateScimGroupCreatedResponse
GetScimGroupResource
ScimUpdateGroupRequest
ScimUpdateGroupOkResponse
GetScimResourceTypes
GetScimServiceProviderConfigInformation about Postman's SCIM API configurations and supported operations.
GetScimUserResources
CreateScimUserRequest
CreateScimUserCreatedResponse
GetScimUserResourceOkResponse
UpdateScimUser
UpdateScimUserState
CreateWebhookRequest
CreateWebhookOkResponse
GetWorkspaces
GetWorkspacesType
GetWorkspacesInclude
CreateWorkspaceRequest
CreateWorkspaceOkResponse
GetWorkspaceRoles
GetWorkspace
UpdateWorkspaceRequest
UpdateWorkspaceOkResponse
DeleteWorkspace
GetWorkspaceGlobalVariablesInformation about the workspace's global variables.
UpdateWorkspaceGlobalVariablesRequest
UpdateWorkspaceGlobalVariablesOkResponseInformation about the workspace's updated global variables.
UpdateWorkspaceRolesRequest
UpdateWorkspaceRolesOkResponse
SalesChannelThe sales channel from which the account was created:
- SELF_SERVE — The user purchased the account plan.
- SALES_SERVE — The account was purchased through the Postman sales team process.
SlotsInformation about the team's slots.
InvoiceDataInformation about the invoice.
TotalAmountInformation about the invoice's total billed amount.
LinksA JSON API spec object containing hypermedia links.
WebAn object containing web-based account references.
GetApisApisThe API's base data schema.
GetApisMetaThe response's meta information for paginated results.
GetApi_1The API's base data schema.
GetApi_2
GitInfoInformation about the API's Git repository integration.
GetApi_2SchemasInformation about the schema.
GetApi_2VersionsInformation about the version.
GetApi_2CollectionsInformation about the collection.
AddApiCollection_1
AddApiCollection_2
AddApiCollection_3
AddApiCollection_1Data
AddApiCollection_1OperationTypeThe COPY_COLLECTION method.
AddApiCollection_2OperationTypeThe GENERATE_FROM_SCHEMA method.
AddApiCollection_3DataInformation about the collection's contents, such as requests and responses. For a complete list of values, refer to the collection.json schema file.
AddApiCollection_3OperationTypeThe CREATE_NEW method.
DataInfoInformation about the collection.
InfoSchemaThe collection's schema format.
CommentResponseDataInformation about the comment.
CommentCreateUpdateTagsInformation about users tagged in the body comment.
UserNameAn object that contains information about the tagged user. The object's name is the user's Postman username. For example, @user-postman.
UserNameTypeThe user value.
CommentCreatedUpdatedData
CreateApiSchemaType_1The schema's type.
CreateApiSchemaFiles_1
FilesRootInformation about the schema's root file.
EnabledIf true, tag the file as the root file. The root tag is only allowed for protobuf specifications.
CreateApiSchemaType_2The schema's type.
CreateApiSchemaFiles_2Information about the schema file.
GetApiSchema_1Information about the schema.
GetApiSchema_2Information about the schema.
GetApiSchema_1FilesInformation about the schema's files. The response is paginated and limited to one page.
FilesDataInformation about the schema file.
FilesMeta
GetApiSchemaFilesMetaThe schema's non-standard meta information.
GetApiSchemaFilesFilesInformation about the schema file.
CreateUpdateApiSchemaFileRootInformation about the schema's root file. This tag only applies to protobuf specifications.
GetStatusOfAnAsyncTaskMetaThe response's non-standard meta information.
GetStatusOfAnAsyncTaskStatusThe task's current status.
Details
MetaModelThe model for which the task is performing the operation.
ActionThe task's action.
Details_1Information about the task's resources.
Details_2Information about the error that occurred during the task's processing.
Details_1Resources
Error
GetApiVersionsMetaThe response's meta information for paginated results.
GetApiVersionsVersionsInformation about the API version.
CreateApiVersion_1Information about the API version.
CreateApiVersion_2Information about the API version.
CreateApiVersion_3Information about the API version.
CreateApiVersion_1SchemasInformation about the schema.
CreateApiVersion_1CollectionsInformation about the collection.
CreateApiVersion_2SchemasInformation about the schema.
CreateApiVersion_2CollectionsInformation about the collection.
CreateApiVersion_3SchemasInformation about the schema.
CreateApiVersion_3CollectionsInformation about the collection.
VersionInformation about the API version.
VersionSchemas
VersionCollections
TagGetPutTagsInformation about the tag.
TagUpdateTagsTagsInformation about the tag.
GetTaggedEntitiesDataAn object containing the paginated elements.
GetTaggedEntitiesMetaThe response's pagination information.
Entities
EntitiesEntityTypeThe type of Postman element.
Trails
TrailsData
ActorInformation about the user who preformed the audit event.
DataUserInformation about the user.
DataTeamThe user's team information.
GetCollectionsCollectionsInformation about the collection.
CollectionsForkIf the collection is forked, the fork's information.
CreateCollectionCollection_1For a complete list of values, refer to the collection.json schema file.
CollectionInfo_1An object that contains basic information about the collection. For a complete list of values, refer to the definitions.info entry in the collection.json schema file.
CollectionItem
CreateCollectionCollection_2
CreateCollectionForkCollectionInformation about the forked collection.
CollectionForkInformation about the collection's fork.
StrategyThe fork's merge strategy:
- deleteSource — Merge the changes into the parent collection. After the merge process is complete, Postman deletes the fork. You must have Editor access to both the parent and forked collections.
- updateSourceWithDestination — Merge the changes into the parent collection. Any differences in the parent collection are also made to the fork.
MergeCollectionForkCollection
PutCollectionCollection_1For a complete list of values, refer to the collection.json schema file.
PutCollectionCollection_2
PatchCollectionCollection_1
CollectionInfo_2An object that contains the collection's updated name and description.
PatchCollectionCollection_2
DeleteCollectionCollectionInformation about the deleted collection.
GetCollectionsForkedByUserDataInformation about the forked collection.
GetCollectionsForkedByUserMetaThe response's meta information for paginated results.
GetCollectionForksDataInformation about the forked collection.
GetCollectionForksMetaThe response's meta information for paginated results.
PullCollectionChangesCollectionInformation about the updated collection fork.
GetCollectionPullRequestsDataInformation about the pull request.
DataStatusThe pull request's current status.
GroupInformation about the group role.
GetCollectionRolesTeamInformation about the team role.
GetCollectionRolesUserInformation about the user role.
GroupRoleThe role type:
- VIEWER — Can view, fork, and export collections.
- EDITOR — Can edit collections directly.
TeamRoleThe role type:
- VIEWER — Can view, fork, and export collections.
- EDITOR — Can edit collections directly.
UserRoleThe role type:
- VIEWER — Can view, fork, and export collections.
- EDITOR — Can edit collections directly.
UpdateCollectionRolesRoles
RolesOpThe operation to perform on the path.
RolesPath_1The resource to perform the action on.
RolesValue_1Information about the updated role.
ValueRole_1The role type:
- VIEWER — Can view, fork, and export collections.
- EDITOR — Can edit collections directly.
GetSourceCollectionStatusCollection
CollectionUidInformation about the forked collection. The object's name is the forked collection's UID (userId-collectionId).
ModeThe transfer operation to perform.
TargetInformation about the item transfer's destination location.
LocationThe transferred items' placement in the target destination:
- For start or end — Do not include the model and id values.
- For before or after — Include the model and id properties.
TargetModelThe collection, folder, or request the items will be transferred to. For response transfers, use the request value.
PositionThe transferred item's position within the destination object.
DeleteCollectionFolderDataThe folder's information.
DeleteCollectionRequestDataThe request's information.
DeleteCollectionResponseDataThe response's information.
StatusesThe secret resolution status type:
- FALSE_POSITIVE — The discovered secret is not an actual secret.
- REVOKED — The secret is valid, but the user rotated their key to resolve the issue.
- ACCEPTED_RISK — The Secret Scanner found the secret, but user accepts the risk of publishing it.
WorkspaceVisiblitiesThe type of visibility setting.
DetectedSecretsQueriesDataInformation about the secret finding.
DetectedSecretsQueriesMetaThe response's meta information for paginated results.
DataResolutionThe secret's current status:
- ACTIVE — The secret is active.
- FALSE_POSITIVE — The discovered secret is not an actual secret.
- REVOKED — The secret is valid, but the user rotated their key to resolve the issue.
- ACCEPTED_RISK — The Secret Scanner found the secret, but user accepts the risk of publishing it.
DataWorkspaceVisibilityThe workspace's visibility setting.
UpdateSecretResolutionsResolution_1The secret's updated resolution status:
- FALSE_POSITIVE — The discovered secret is not an actual secret.
- REVOKED — The secret is valid, but the user rotated their key to resolve the issue.
- ACCEPTED_RISK — The Secret Scanner found the secret, but user accepts the risk of publishing it.
History
UpdateSecretResolutionsResolution_2The secret's current resolution status:
- ACTIVE — The secret is active.
- FALSE_POSITIVE — The discovered secret is not an actual secret.
- REVOKED — The secret is valid, but the user rotated their key to resolve the issue.
- ACCEPTED_RISK — The Secret Scanner found the secret, but user accepts the risk of publishing it.
HistoryResolutionThe secret's updated resolution status:
- ACTIVE — The secret is active.
- FALSE_POSITIVE — The discovered secret is not an actual secret.
- REVOKED — The secret is valid, but the user rotated their key to resolve the issue.
- ACCEPTED_RISK — The Secret Scanner found the secret, but user accepts the risk of publishing it.
GetSecretsLocationsDataInformation about the secret finding locations.
GetSecretsLocationsMeta
DataResourceTypeThe type of resource in which the secret was detected.
ActivityFeed
ActivityFeedStatusThe secret's current resolution status:
- ACTIVE — The secret is active.
- FALSE_POSITIVE — The discovered secret is not an actual secret.
- REVOKED — The secret is valid, but the user rotated their key to resolve the issue.
- ACCEPTED_RISK — The Secret Scanner found the secret, but user accepts the risk of publishing it.
GetSecretTypesDataInformation about the secret type.
GetSecretTypesMeta
DataTypeThe origin of the secret type:
- DEFAULT — Supported by default in Postman.
- TEAM_REGEX — A custom regex added by an Admin or Super Admin user in the Configure Alerts section of the Team Settings interface.
GetEnvironmentsEnvironments
CreateEnvironmentEnvironment_1
EnvironmentValues_1
ValuesType_1The variable type.
CreateEnvironmentEnvironment_2
GetEnvironmentEnvironment
EnvironmentValues_2
ValuesType_2The variable type.
UpdateEnvironmentEnvironment_1
EnvironmentValues_3
ValuesType_3The variable type.
UpdateEnvironmentEnvironment_2
DeleteEnvironmentEnvironment
GetEnvironmentForksDataInformation about the forked environment.
GetEnvironmentForksMetaThe response's meta information for paginated results.
ForkEnvironmentEnvironmentInformation about the forked environment.
MergeEnvironmentForkEnvironmentInformation about the merged environment.
PullEnvironmentEnvironmentInformation about the merged environment.
JsonSchema
JsonStringified
JsonSchemaTypeThe OpenAPI definition type.
JsonStringifiedTypeThe OpenAPI definition type.
ImportExportFileTypeThe file type value.
ImportOpenApiDefinitionCollections
GetAuthenticatedUserUserInformation about the authenticated user.
GetAuthenticatedUserOperations
GetMocksMocksInformation about the mock servers.
MocksConfigInformation about the mock server's configuration.
DelayInformation about the mock server's simulated network delay settings. This returns a null value if there are no configured network delay settings.
DelayTypeThe type of simulated delay value:
- fixed — The delay value is a fixed value.
PresetThe simulated fixed network delay value:
- 1 — 2G (300 ms).
- 2 — 3G (100 ms).
The object does not return this value for custom delay values.
CreateMockMock
MockCreateUpdateMockInformation about the mock server.
GetMockMock
MockConfig_1Information about the mock server's configuration.
UpdateMockMock
MockConfig_2The mock server's configuration settings.
DeleteMockMockInformation about the mock server.
CallLogsInformation about the mock server's server responses.
GetMockCallLogsMetaThe response's non-standard meta information.
CallLogsRequestThe server response's request information.
CallLogsResponseThe server response's response information.
RequestHeadersThe request's headers.
RequestBodyThe request's body information.
ResponseHeadersThe response's headers.
ResponseBodyThe response's body information.
DescriptionThe response header's description information.
PublishMockMock
UnpublishMockMock
CreateMockServerResponseServerResponse
ServerResponseHeaders_1
ServerResponseLanguage_1The server response's body language type.
UpdateMockServerResponseServerResponse
ServerResponseHeaders_2Information about they key-value pair.
ServerResponseLanguage_2The server response's body language type.
DeleteMockServerResponseHeaders
DeleteMockServerResponseLanguageThe server response's body language type.
GetMonitorsMonitors
CreateMonitorMonitor_1
MonitorSchedule_1Information about the monitor's schedule.
CreateMonitorMonitor_2
GetMonitorMonitor
LastRunInformation about the monitor's previous run.
NotificationsInformation about the monitor's notification settings.
OptionsInformation about the monitor's option settings.
MonitorSchedule_2Information about the monitor's schedule.
LastRunStatsInformation about the monitor's stats.
StatsAssertions_1Information about the monitor's assertions.
StatsRequests_1Information about the monitor's requests.
OnError
OnFailure
UpdateMonitorMonitor_1
MonitorSchedule_3Information about the monitor's schedule.
UpdateMonitorMonitor_2
DeleteMonitorMonitor
RunInformation about the monitor run.
RunInfoInformation about the monitor.
RunStatsInformation about the monitor run's stats.
Executions
StatsAssertions_2The monitor run's assertions stats.
StatsRequests_2The monitor run's request stats.
ExecutionsItemInformation about the executed item.
ExecutionsRequestInformation about the monitor run's requests.
ExecutionsResponseInformation about the monitor run's response.
Elements
Folders
GetPanElementsAndFoldersMetaThe response's non-standard meta information.
PanCreateApi
PanCreateCollection
PanCreateWorkspace
PanCreateFolder
PanCreateApiApi
PanCreateCollectionCollection
PanCreateWorkspaceWorkspace
PanCreateFolderFolder
PanElementCreatedInformation about the Private API Network element.
PanFolderCreatedInformation about the Private API Network folder.
UpdatePanApi
UpdatePanCollection
UpdatePanWorkspace
UpdatePanFolder
UpdatePanApiApi
UpdatePanCollectionCollection
CollectionEnvironmentsThe collection's updated environments.
UpdatePanWorkspaceWorkspace
UpdatePanFolderFolder
DeletePanElementOrFolderElementTypeThe Private API Network element type. The name of the object is the element api, collection, workspace, or folder type.
GetAllPanAddElementRequestsRequests
GetAllPanAddElementRequestsMetaThe response's non-standard meta information.
RequestsStatusThe request's status.
RequestsElementInformation about the requested element.
RequestsResponseInformation about the response to the request. This object only returns when the network manager denied a request with a message.
ElementType_1The element type.
RespondPanElementAddRequestResponseThe response to the user's request.
RespondPanElementAddRequestStatusThe request's status.
RespondPanElementAddRequestRequest_2
RequestResponseInformation about the response to the element's request. This object only returns when the network manager denied a request with a message.
RequestElementInformation about the requested element.
RequestStatusThe request's status.
ElementType_2The element type.
SourceInformation about the pull request's source (parent) element.
DestinationInformation about the pull request destination element.
MergeInformation about the current progress of the pull request's merge.
Reviewers
MergeStatusThe pull request's current merge status:
- inactive — There is no merge in progress.
- inprogress — The pull request is currently merging.
- failed — The pull request's merge failed.
PullRequestUpdatedStatusThe pull request's status.
SchemaSecurityValidationSchema
SchemaLanguageThe definition format.
SchemaTypeThe definition type.
ScimGroupResourceThe SCIM group resource object.
ScimGroupResourceMembersInformation about the group's members.
ScimGroupResourceMetaThe response's non-standard meta information.
CreateScimGroupMembers_1An object containing the SCIM users to assign to the group.
CreateScimGroupMembers_2An object containing the group's assigned SCIM members.
CreateScimGroupMetaThe response's non-standard meta information.
GetScimGroupResourceMembers
GetScimGroupResourceMetaThe response's non-standard meta information.
ScimUpdateGroupOperations
OperationsOp_1The operation to perform.
OperationsValue_1The performed operation's value.
ScimUpdateGroupMetaThe response's non-standard meta information.
SchemaExtensions
PatchInformation about patch configuration.
BulkInformation about bulk configuration.
FilterInformation about the filter configuration.
ChangePasswordInformation about the change password configuration.
GetScimServiceProviderConfigSortInformation about the sort configuration.
AuthenticationSchemesInformation about the scheme.
EtagInformation about the entity tag (Etag) HTTP response header configuration.
GetScimServiceProviderConfigMetaThe response's non-standard meta information.
ResourcesThe SCIM user resource object.
ScimUserResourceName_1Information about the Postman team member.
ScimUserResourceMeta_1The response's non-standard meta information.
CreateScimUserName_1Information about the user's name.
CreateScimUserName_2
CreateScimUserMetaThe response's non-standard meta information.
MetaResourceTypeThe SCIM resource type.
ScimUserResourceName_2Information about the Postman team member.
ScimUserResourceMeta_2The response's non-standard meta information.
UpdateScimUserNameInformation about the user's name.
UpdateScimUserStateOperations
OperationsOp_2The operation to perform.
OperationsValue_2The performed operation's value.
CreateWebhookWebhook_1
CreateWebhookWebhook_2
WorkspacesInformation about the workspace.
WorkspacesTypeThe type of workspace.
WorkspacesVisibilityThe workspace's visibility. Visibility determines who can access the workspace:
- personal — Only you can access the workspace.
- team — All team members can access the workspace.
- private — Only invited team members can access the workspace (Professional and Enterprise plans only).
- public — Everyone can access the workspace.
- partner — Only invited team members and partners can access the workspace (Professional and Enterprise plans only).
CreateWorkspaceWorkspace_1Information about the workspace.
WorkspaceType_1The type of workspace:
- personal
- private — Private workspaces are available on Postman Professional and Enterprise plans.
- public
- team
- partnerPartner Workspaces are available on Postman Professional and Enterprise plans).
CreateWorkspaceWorkspace_2Information about the created workspace.
GetWorkspaceRolesRolesInformation about the workspace's user roles.
RolesUserInformation about the user role.
UsergroupInformation about the user group in the workspace.
GetWorkspaceWorkspaceInformation about the workspace.
WorkspaceType_2The type of workspace.
WorkspaceVisibilityThe workspace's visibility. Visibility determines who can access the workspace:
- personal — Only you can access the workspace.
- team — All team members can access the workspace.
- private — Only invited team members can access the workspace (Professional and Enterprise plans only).
- public — Everyone can access the workspace.
- partner — Only invited team members and partners can access the workspace (Professional and Enterprise plans only).
WorkspaceCollectionsInformation about the collection.
WorkspaceEnvironmentsInformation about the environment.
WorkspaceMocksInformation about the mock server.
WorkspaceMonitorsInformation about the monitor.
WorkspaceApisInformation about the API.
UpdateWorkspaceWorkspace_1
WorkspaceType_3The new workspace visibility type. This property does not support the following workspace visibility changes:
- private to public, public to private, and private to personal for Free and Basic plans.
- public to personal for team users.
UpdateWorkspaceWorkspace_2Information about the updated workspace.
DeleteWorkspaceWorkspaceInformation about the deleted workspace.
GlobalVariableInformation about the global variable.
GlobalVariableTypeThe type of variable.
UpdateWorkspaceRolesRoles_1
RolesPath_2The resource to perform the action on.
RolesValue_2Information about the updated user or user group role.
ValueRole_2The workspace role's ID:
- 1 — Viewer. Can view, fork, and export workspace resources.
- 2 — Editor. Can create and edit workspace resources.
- 3 — Admin. Can manage workspace details and members.
UpdateWorkspaceRolesRoles_2
DisplayNameThe role's display name.

License

This SDK is licensed under the MIT License.

See the LICENSE file for more details.

FAQs


Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc