/swaggerhub | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
swaggerhub_add_api_comment_reply_v2 | Reply to a comment |
swaggerhub_add_api_comment_v2 | Add a new comment |
swaggerhub_add_domain_comment_reply_v2 | Reply to a comment |
swaggerhub_add_domain_comment_v2 | Add a new comment |
swaggerhub_add_spec_to_project_v2 | Add an API or domain to a project |
swaggerhub_clone_api | Create a new API version |
swaggerhub_clone_domain | Create a new domain version |
swaggerhub_create_integration | Create an integration for the specified API and version |
swaggerhub_create_project | Create a project in an organization |
swaggerhub_delete_api | Delete an API |
swaggerhub_delete_api_comment_reply_v2 | Delete a comment reply |
swaggerhub_delete_api_comment_v2 | Delete a comment |
swaggerhub_delete_api_version | Delete an API version |
swaggerhub_delete_domain | Delete a domain |
swaggerhub_delete_domain_comment_reply_v2 | Delete a comment reply |
swaggerhub_delete_domain_comment_v2 | Delete a comment |
swaggerhub_delete_domain_version | Delete a domain version |
swaggerhub_delete_integration | Delete an integration |
swaggerhub_delete_project_v2 | Delete a project |
swaggerhub_delete_template | Delete a template |
swaggerhub_delete_template_version | Delete a particular version of a template |
swaggerhub_execute_integration | Run an integration |
swaggerhub_fork_api | Fork an API |
swaggerhub_fork_domain | Fork a domain |
swaggerhub_fork_template | Create a fork for a template |
swaggerhub_get_api_comments_v2 | Get comments for the specified API version |
swaggerhub_get_api_default_version | Get the default version of an API |
swaggerhub_get_api_versions | Get a list of API versions |
swaggerhub_get_definition | Get the OpenAPI definition of the specified API version |
swaggerhub_get_domain_comments_v2 | Get comments for the specified domain version |
swaggerhub_get_domain_default_version | Get the default version of a domain |
swaggerhub_get_domain_definition | Get the OpenAPI definition of the specified domain version |
swaggerhub_get_domain_json_definition | Get the OpenAPI definition for the specified domain version in JSON format |
swaggerhub_get_domain_lifecycle_settings | Get the published status for the specified domain and version |
swaggerhub_get_domain_private_settings | Get the visibility (public or private) of a domain version |
swaggerhub_get_domain_versions | Get a list of domain versions |
swaggerhub_get_domain_yaml_definition | Get the OpenAPI definition for the specified domain version in YAML format |
swaggerhub_get_integration_by_id | Get integration settings |
swaggerhub_get_integrations | Get all integrations configured for the specified API version |
swaggerhub_get_json_definition | Get the OpenAPI definition for the specified API version in JSON format |
swaggerhub_get_lifecycle_settings | Get the published status for the specified API and version |
swaggerhub_get_org_projects_v2 | Get all projects of an organization |
swaggerhub_get_owner_apis | Get a list of APIs of the specified owner |
swaggerhub_get_owner_domains | Get a list of domains of the specified owner |
swaggerhub_get_private_settings | Get the visibility (public or private) of API version |
swaggerhub_get_project_members_v2 | Get project members |
swaggerhub_get_project_v2 | Get project information |
swaggerhub_get_standardization_errors | Retrieve the standardization errors for a given API definition |
swaggerhub_get_template_comments | Return the list of comments for a template |
swaggerhub_get_template_definition | Retrieve a template definition |
swaggerhub_get_template_lifecycle_settings | Retrieve lifecycle settings for a template |
swaggerhub_get_template_private_settings | Retrieve visibility settings for a template |
swaggerhub_get_template_versions | Retrieve an APIs.json listing for all template versions for an owner and template |
swaggerhub_get_templates | Retrieve a list of templates for an owner |
swaggerhub_get_user_projects | Get all projects that a user has access to |
swaggerhub_get_yaml_definition | Get the OpenAPI definition for the specified API version in YAML format |
swaggerhub_patch_integration | Partially update integration settings |
swaggerhub_rename_api | Rename an API |
swaggerhub_rename_domain | Rename a domain |
swaggerhub_rename_template | Rename a template |
swaggerhub_save_definition | Create or update an API |
swaggerhub_save_domain_definition | Create or update a domain |
swaggerhub_save_project_v2 | Update a project |
swaggerhub_save_template_definition | Create or update a template |
swaggerhub_search_apis | Search APIs |
swaggerhub_search_apis_and_domains | Retrieve a list of currently defined APIs, domains, and templates in APIs.json format |
swaggerhub_search_domains | Search domains |
swaggerhub_set_api_comment_status_v2 | Resolve or reopen a comment |
swaggerhub_set_api_default_version | Set the default API version |
swaggerhub_set_domain_comment_status_v2 | Resolve or reopen a comment |
swaggerhub_set_domain_default_version | Set the default version for a domain |
swaggerhub_set_domain_lifecycle_settings | Publish or unpublish a domain version |
swaggerhub_set_domain_private_settings | Set the visibility (public or private) of a domain version |
swaggerhub_set_lifecycle_settings | Publish or unpublish an API version |
swaggerhub_set_private_settings | Set the visibility (public or private) of an API version |
swaggerhub_set_template_lifecycle_settings | Update lifecycle settings for a template |
swaggerhub_set_template_private_settings | Update visibility settings for a template |
swaggerhub_update_api_comment_reply_v2 | Update a comment reply |
swaggerhub_update_api_comment_v2 | Update a comment |
swaggerhub_update_api_comments_v2 | Bulk update comments |
swaggerhub_update_domain_comment_reply_v2 | Update a comment reply |
swaggerhub_update_domain_comment_v2 | Update a comment |
swaggerhub_update_domain_comments_v2 | Bulk update comments |
swaggerhub_update_integration | Update integration settings |
swaggerhub_update_project_members_v2 | Update a project’s members list |
swaggerhub_update_template_comments | Update the list of comments for a template |
swaggerhub_add_api_comment_reply_v2
Reply to a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
body | string | Yes | — | The body value |
swaggerhub_add_api_comment_v2
Add a new comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
body | string | Yes | — | The body value |
position | integer | Yes | — | The position value |
replies | object[] | No | — | The replies value |
swaggerhub_add_domain_comment_reply_v2
Reply to a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
body | string | Yes | — | The body value |
swaggerhub_add_domain_comment_v2
Add a new comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
body | string | Yes | — | The body value |
position | integer | Yes | — | The position value |
replies | object[] | No | — | The replies value |
swaggerhub_add_spec_to_project_v2
Add an API or domain to a project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
projectId | string | Yes | — | Project name (case-sensitive) |
specType | string | Yes | — | Definition type - apis or domains. |
name | string | Yes | — | The name of an API or domain that you want to add to the project. Case-sensitive. |
swaggerhub_clone_api
Create a new API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | The version to clone (case-sensitive) |
private | boolean | No | — | Whether the new version should be public (false) or private (true) |
swaggerhub_clone_domain
Create a new domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | The version to clone (case-sensitive) |
private | boolean | No | — | Whether the new version should be public (false) or private (true) |
swaggerhub_create_integration
Create an integration for the specified API and version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
body | object | Yes | — | Can be one of the following objects: | configType value | Object | | ------------------------- | ------ | | AMAZON_API_GATEWAY | AmazonApiGatewayIntegration | | AMAZON_API_GATEWAY_LAMBDA | AmazonApiGatewayLambdaIntegration | | API_AUTO_MOCKING | AutoMockingIntegration | | APIGEE_EDGE | ApigeeEdgeIntegration | | AZURE_API_MANAGEMENT | AzureApiManagementIntegration | | AZURE_DEVOPS_SERVICES | AzureDevopsServicesIntegration | | BITBUCKET_CLOUD | BitbucketCloudIntegration | | BITBUCKET_SERVER | BitbucketServerIntegration | | GITHUB | GitHubIntegration | | GITHUB_ENTERPRISE | GitHubEnterpriseIntegration | | GITLAB | GitLabIntegration | | IBM_API_CONNECT | IBMApiConnectIntegration | | WEBHOOK | WebhookIntegration | For more examples, see the JSON files in this repository: https://github.com/SmartBear/swaggerhub-cli/tree/master/examples/integrations |
swaggerhub_create_project
Create a project in an organization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
apis | string[] | No | — | A list of APIs included in this project. The APIs must belong to the same owner as the project. API names are case-sensitive. |
description | string | No | — | Project description |
domains | string[] | No | — | A list of domains included in this project. The domains must belong to the same owner as the project. Domain names are case-sensitive. |
name | string | No | — | Project name |
swaggerhub_delete_api
Delete an API Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
swaggerhub_delete_api_comment_reply_v2
Delete a comment reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
reply | string | Yes | — | Reply identifier |
swaggerhub_delete_api_comment_v2
Delete a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
swaggerhub_delete_api_version
Delete an API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_delete_domain
Delete a domain Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
force | boolean | No | — | If this domain is referenced from other APIs and domains, this parameter must be true. Otherwise, the request will be rejected with status code 424. |
swaggerhub_delete_domain_comment_reply_v2
Delete a comment reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
reply | string | Yes | — | Reply identifier |
swaggerhub_delete_domain_comment_v2
Delete a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
swaggerhub_delete_domain_version
Delete a domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
force | boolean | No | — | If this domain version is referenced from other APIs and domains, this parameter must be true. Otherwise, the request will be rejected with status code 424. |
swaggerhub_delete_integration
Delete an integration Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
integrationId | string | Yes | — | Integration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations |
swaggerhub_delete_project_v2
Delete a project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
projectId | string | Yes | — | Project name (case-sensitive) |
swaggerhub_delete_template
Delete a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
swaggerhub_delete_template_version
Delete a particular version of a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
swaggerhub_execute_integration
Run an integration Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
integrationId | string | Yes | — | Integration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations |
commitMessage | string | No | — | Commit message for source control integrations |
swaggerhub_fork_api
Fork an API Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
name | string | Yes | — | The name for the forked definition. Must follow the naming rules. Can be the name of an existing definition, in which case the fork will become a new version in that definition, unless that version already exists. |
private | boolean | No | — | Whether the forked version should be public (false) or private (true). If the value is not set, the original version’s setting will be used. |
project | string | No | — | If forking into an organization, you can optionally specify an existing project to add the forked definition to. |
swaggerhub_fork_domain
Fork a domain Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
name | string | Yes | — | The name for the forked definition. Must follow the naming rules. Can be the name of an existing definition, in which case the fork will become a new version in that definition, unless that version already exists. |
private | boolean | No | — | Whether the forked version should be public (false) or private (true). If the value is not set, the original version’s setting will be used. |
project | string | No | — | If forking into an organization, you can optionally specify an existing project to add the forked definition to. |
swaggerhub_fork_template
Create a fork for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
name | string | Yes | — | The name for the forked definition. Must follow the naming rules. Can be the name of an existing definition, in which case the fork will become a new version in that definition, unless that version already exists. |
private | boolean | No | — | Whether the forked version should be public (false) or private (true). If the value is not set, the original version’s setting will be used. |
project | string | No | — | If forking into an organization, you can optionally specify an existing project to add the forked definition to. |
swaggerhub_get_api_comments_v2
Get comments for the specified API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_api_default_version
Get the default version of an API Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
swaggerhub_get_api_versions
Get a list of API versions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
swaggerhub_get_definition
Get the OpenAPI definition of the specified API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
resolved | boolean | No | — | Set to true to get the resolved version of the API definition. The content of all external $refs will be included in the resulting file. |
flatten | boolean | No | — | If set to true, it creates models from inline schemas in OpenAPI definition. AsyncAPI definitions cannot be flattened. |
swaggerhub_get_domain_comments_v2
Get comments for the specified domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_domain_default_version
Get the default version of a domain Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
swaggerhub_get_domain_definition
Get the OpenAPI definition of the specified domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_domain_json_definition
Get the OpenAPI definition for the specified domain version in JSON format Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_domain_lifecycle_settings
Get the published status for the specified domain and version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_domain_private_settings
Get the visibility (public or private) of a domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_domain_versions
Get a list of domain versions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
swaggerhub_get_domain_yaml_definition
Get the OpenAPI definition for the specified domain version in YAML format Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_integration_by_id
Get integration settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
integrationId | string | Yes | — | Integration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations |
swaggerhub_get_integrations
Get all integrations configured for the specified API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_json_definition
Get the OpenAPI definition for the specified API version in JSON format Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
resolved | boolean | No | — | Set to true to get the resolved version of the API definition. The content of all external $refs will be included in the resulting file. |
flatten | boolean | No | — | If set to true, it creates models from inline schemas in OpenAPI definition. AsyncAPI definitions cannot be flattened. |
swaggerhub_get_lifecycle_settings
Get the published status for the specified API and version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_org_projects_v2
Get all projects of an organization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
nameOnly | boolean | No | — | Return the project information excluding APIs and domains |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
order | string | No | — | Sort order |
swaggerhub_get_owner_apis
Get a list of APIs of the specified owner Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
sort | string | No | — | Sort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title |
order | string | No | — | Sort order |
swaggerhub_get_owner_domains
Get a list of domains of the specified owner Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
sort | string | No | — | Sort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title |
order | string | No | — | Sort order |
swaggerhub_get_private_settings
Get the visibility (public or private) of API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
swaggerhub_get_project_members_v2
Get project members Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
projectId | string | Yes | — | Project name (case-sensitive) |
swaggerhub_get_project_v2
Get project information Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
projectId | string | Yes | — | Project name (case-sensitive) |
swaggerhub_get_standardization_errors
Retrieve the standardization errors for a given API definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | The api value |
version | string | Yes | — | Version identifier |
swaggerhub_get_template_comments
Return the list of comments for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
swaggerhub_get_template_definition
Retrieve a template definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
flatten | boolean | No | — | If set to true, it creates models from inline schemas in OpenAPI definition. AsyncAPI definitions cannot be flattened. |
swaggerhub_get_template_lifecycle_settings
Retrieve lifecycle settings for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
swaggerhub_get_template_private_settings
Retrieve visibility settings for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
swaggerhub_get_template_versions
Retrieve an APIs.json listing for all template versions for an owner and template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
swaggerhub_get_templates
Retrieve a list of templates for an owner Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | No | — | Owner name |
swaggerhub_get_user_projects
Get all projects that a user has access to Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
nameOnly | boolean | No | — | Return the project information excluding APIs and domains |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
sort | string | No | — | Sort criteria or result set: * NAME * OWNER |
order | string | No | — | Sort order |
swaggerhub_get_yaml_definition
Get the OpenAPI definition for the specified API version in YAML format Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
resolved | boolean | No | — | Set to true to get the resolved version of the API definition. The content of all external $refs will be included in the resulting file. |
flatten | boolean | No | — | If set to true, it creates models from inline schemas in OpenAPI definition. AsyncAPI definitions cannot be flattened. |
swaggerhub_patch_integration
Partially update integration settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
integrationId | string | Yes | — | Integration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations |
body | object | Yes | — | An object that contains the integration parameters you want to update |
swaggerhub_rename_api
Rename an API Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
newName | string | Yes | — | New name |
swaggerhub_rename_domain
Rename a domain Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
newName | string | Yes | — | New name |
force | boolean | No | — | If this domain is referenced from other APIs and domains, this parameter must be true. Otherwise, the request will be rejected with status code 424. |
swaggerhub_rename_template
Rename a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
newName | string | Yes | — | New name |
swaggerhub_save_definition
Create or update an API Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner name (organization or user name, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
isPrivate | boolean | No | — | Whether to make the API private (true) or public (false) |
version | string | No | — | API version to create or update. If omitted, the version is extracted from the info.version field of the provided OpenAPI definition. Either the version parameter or the info.version value must be specified, otherwise the request will be rejected. If both are specified, the version parameter overrides the info.version value. If this API version already exists, it will be updated with the new definition (unless that version has been published - in this case the update will be rejected). |
force | boolean | No | — | Force update |
body | string | Yes | — | OpenAPI definition in the YAML or JSON format. The content must be syntactically valid YAML or JSON. |
swaggerhub_save_domain_definition
Create or update a domain Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
isPrivate | boolean | No | — | Specifies whether the domain has to be private |
version | string | No | — | Domain version. If omitted, will be taken from the info.version field in the definition. |
force | boolean | No | — | Force update |
body | string | No | — | OpenAPI definition of this domain |
swaggerhub_save_project_v2
Update a project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
projectId | string | Yes | — | Project name (case-sensitive) |
apis | string[] | No | — | A list of APIs included in this project. The APIs must belong to the same owner as the project. API names are case-sensitive. |
description | string | No | — | Project description |
domains | string[] | No | — | A list of domains included in this project. The domains must belong to the same owner as the project. Domain names are case-sensitive. |
name | string | No | — | Project name |
swaggerhub_save_template_definition
Create or update a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
isPrivate | boolean | No | — | Defines whether the API or template has to be private |
version | string | No | — | Template version to create or update. If omitted, the version will be taken from the info.version field in the definition. |
force | boolean | No | — | Force update |
projectName | string | No | — | The project to add the API, domain, or template to |
body | string | Yes | — | The template definition |
swaggerhub_search_apis
Search APIs Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | No | — | Free text query to match |
state | string | No | — | Matches against published state of the spec: * UNPUBLISHED - spec is a draft, a work in progress * PUBLISHED - spec is a stable version ready for consuming from client applications * ANY - either PUBLISHED or UNPUBLISHED |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
sort | string | No | — | Sort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title |
order | string | No | — | Sort order |
swaggerhub_search_apis_and_domains
Retrieve a list of currently defined APIs, domains, and templates in APIs.json format Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
specType | string | No | — | Type of definitions to search: * API - APIs only * DOMAIN - domains only * TEMPLATE - templates only * ANY - APIs, domains, and templates |
visibility | string | No | — | The visibility of a definition in SwaggerHub: * PUBLIC - can be viewed by anyone * PRIVATE - can only be viewed by you or your organization and those that you are collaborating with or have shared it with * ANY - either PUBLIC or PRIVATE |
state | string | No | — | Matches against published state of the spec: * UNPUBLISHED - spec is a draft, a work in progress * PUBLISHED - spec is a stable version ready for consuming from client applications * ANY - either PUBLISHED or UNPUBLISHED |
owner | string | No | — | API or domain owner. Can be username or organization name. Case-sensitive. |
query | string | No | — | Free text query to match |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
sort | string | No | — | Sort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title |
order | string | No | — | Sort order |
swaggerhub_search_domains
Search domains Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | No | — | Free text query to match |
state | string | No | — | Matches against published state of the spec: * UNPUBLISHED - spec is a draft, a work in progress * PUBLISHED - spec is a stable version ready for consuming from client applications * ANY - either PUBLISHED or UNPUBLISHED |
page | integer | No | — | Page to return |
limit | integer | No | — | Number of results per page (1 .. 100) |
sort | string | No | — | Sort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title |
order | string | No | — | Sort order |
swaggerhub_set_api_comment_status_v2
Resolve or reopen a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
status | string | Yes | — | Comment status |
swaggerhub_set_api_default_version
Set the default API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier (case-insensitive) |
swaggerhub_set_domain_comment_status_v2
Resolve or reopen a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
status | string | Yes | — | Comment status |
swaggerhub_set_domain_default_version
Set the default version for a domain Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier (case-insensitive) |
swaggerhub_set_domain_lifecycle_settings
Publish or unpublish a domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
force | boolean | No | — | To publish a domain that references other unpublished domains, this parameter must be true. Otherwise, the request will be rejected with status code 424. |
published | boolean | No | — | Whether the definition is published (true) or unpublished (false) |
swaggerhub_set_domain_private_settings
Set the visibility (public or private) of a domain version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
force | boolean | No | — | To change the visibility from public to private in case this domain is referenced from other public definitions, this parameter must be true. Otherwise, the request will be rejected with status code 424. |
private | boolean | Yes | — | Whether the definition version is private (true) or public (false) |
swaggerhub_set_lifecycle_settings
Publish or unpublish an API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
force | boolean | No | — | To publish an API that references unpublished domains, this parameter must be true. Otherwise, the request will be rejected with status code 424. |
published | boolean | No | — | Whether the definition is published (true) or unpublished (false) |
swaggerhub_set_private_settings
Set the visibility (public or private) of an API version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
private | boolean | Yes | — | Whether the definition version is private (true) or public (false) |
swaggerhub_set_template_lifecycle_settings
Update lifecycle settings for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
force | boolean | No | — | Force update |
published | boolean | No | — | Whether the definition is published (true) or unpublished (false) |
swaggerhub_set_template_private_settings
Update visibility settings for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
private | boolean | Yes | — | Whether the definition version is private (true) or public (false) |
swaggerhub_update_api_comment_reply_v2
Update a comment reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
reply | string | Yes | — | Reply identifier |
body | string | No | — | The body value |
swaggerhub_update_api_comment_v2
Update a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
body | string | No | — | The body value |
position | integer | No | — | The position value |
swaggerhub_update_api_comments_v2
Bulk update comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
addComment | object[] | No | — | Add Comment |
addReply | object | No | — | Add Reply |
deleteComment | string[] | No | — | Delete Comment |
deleteReply | object | No | — | Delete Reply |
updateComment | object | No | — | Update Comment |
updateReply | object | No | — | Update Reply |
updateStatus | object | No | — | Update Status |
swaggerhub_update_domain_comment_reply_v2
Update a comment reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
reply | string | Yes | — | Reply identifier |
body | string | No | — | The body value |
swaggerhub_update_domain_comment_v2
Update a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
comment | string | Yes | — | Comment identifier |
body | string | No | — | The body value |
position | integer | No | — | The position value |
swaggerhub_update_domain_comments_v2
Bulk update comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Domain owner (organization or user, case-sensitive) |
domain | string | Yes | — | Domain name (case-sensitive) |
version | string | Yes | — | Version identifier |
addComment | object[] | No | — | Add Comment |
addReply | object | No | — | Add Reply |
deleteComment | string[] | No | — | Delete Comment |
deleteReply | object | No | — | Delete Reply |
updateComment | object | No | — | Update Comment |
updateReply | object | No | — | Update Reply |
updateStatus | object | No | — | Update Status |
swaggerhub_update_integration
Update integration settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API owner (organization or user, case-sensitive) |
api | string | Yes | — | API name (case-sensitive) |
version | string | Yes | — | Version identifier |
integrationId | string | Yes | — | Integration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations |
body | object | Yes | — | Can be one of the following objects: | configType value | Object | | ------------------------- | ------ | | AMAZON_API_GATEWAY | AmazonApiGatewayIntegration | | AMAZON_API_GATEWAY_LAMBDA | AmazonApiGatewayLambdaIntegration | | API_AUTO_MOCKING | AutoMockingIntegration | | APIGEE_EDGE | ApigeeEdgeIntegration | | AZURE_API_MANAGEMENT | AzureApiManagementIntegration | | AZURE_DEVOPS_SERVICES | AzureDevopsServicesIntegration | | BITBUCKET_CLOUD | BitbucketCloudIntegration | | BITBUCKET_SERVER | BitbucketServerIntegration | | GITHUB | GitHubIntegration | | GITHUB_ENTERPRISE | GitHubEnterpriseIntegration | | GITLAB | GitLabIntegration | | IBM_API_CONNECT | IBMApiConnectIntegration | | WEBHOOK | WebhookIntegration | For more examples, see the JSON files in this repository: https://github.com/SmartBear/swaggerhub-cli/tree/master/examples/integrations |
swaggerhub_update_project_members_v2
Update a project’s members list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Organization name (case-sensitive) |
projectId | string | Yes | — | Project name (case-sensitive) |
members | object[] | No | — | The members value |
swaggerhub_update_template_comments
Update the list of comments for a template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | API, domain, or template owner identifier (case-sensitive) |
templateId | string | Yes | — | Template identifier |
version | string | Yes | — | Version identifier |
addComment | object[] | No | — | Add Comment |
addReply | object | No | — | Add Reply |
deleteComment | string[] | No | — | Delete Comment |
deleteReply | object | No | — | Delete Reply |
updateComment | object | No | — | Update Comment |
updateReply | object | No | — | Update Reply |
updateStatus | object | No | — | Update Status |

