Skip to main content
Server path: /swaggerhub | Type: Application | PCID required: Yes

Tools

ToolDescription
swaggerhub_add_api_comment_reply_v2Reply to a comment
swaggerhub_add_api_comment_v2Add a new comment
swaggerhub_add_domain_comment_reply_v2Reply to a comment
swaggerhub_add_domain_comment_v2Add a new comment
swaggerhub_add_spec_to_project_v2Add an API or domain to a project
swaggerhub_clone_apiCreate a new API version
swaggerhub_clone_domainCreate a new domain version
swaggerhub_create_integrationCreate an integration for the specified API and version
swaggerhub_create_projectCreate a project in an organization
swaggerhub_delete_apiDelete an API
swaggerhub_delete_api_comment_reply_v2Delete a comment reply
swaggerhub_delete_api_comment_v2Delete a comment
swaggerhub_delete_api_versionDelete an API version
swaggerhub_delete_domainDelete a domain
swaggerhub_delete_domain_comment_reply_v2Delete a comment reply
swaggerhub_delete_domain_comment_v2Delete a comment
swaggerhub_delete_domain_versionDelete a domain version
swaggerhub_delete_integrationDelete an integration
swaggerhub_delete_project_v2Delete a project
swaggerhub_delete_templateDelete a template
swaggerhub_delete_template_versionDelete a particular version of a template
swaggerhub_execute_integrationRun an integration
swaggerhub_fork_apiFork an API
swaggerhub_fork_domainFork a domain
swaggerhub_fork_templateCreate a fork for a template
swaggerhub_get_api_comments_v2Get comments for the specified API version
swaggerhub_get_api_default_versionGet the default version of an API
swaggerhub_get_api_versionsGet a list of API versions
swaggerhub_get_definitionGet the OpenAPI definition of the specified API version
swaggerhub_get_domain_comments_v2Get comments for the specified domain version
swaggerhub_get_domain_default_versionGet the default version of a domain
swaggerhub_get_domain_definitionGet the OpenAPI definition of the specified domain version
swaggerhub_get_domain_json_definitionGet the OpenAPI definition for the specified domain version in JSON format
swaggerhub_get_domain_lifecycle_settingsGet the published status for the specified domain and version
swaggerhub_get_domain_private_settingsGet the visibility (public or private) of a domain version
swaggerhub_get_domain_versionsGet a list of domain versions
swaggerhub_get_domain_yaml_definitionGet the OpenAPI definition for the specified domain version in YAML format
swaggerhub_get_integration_by_idGet integration settings
swaggerhub_get_integrationsGet all integrations configured for the specified API version
swaggerhub_get_json_definitionGet the OpenAPI definition for the specified API version in JSON format
swaggerhub_get_lifecycle_settingsGet the published status for the specified API and version
swaggerhub_get_org_projects_v2Get all projects of an organization
swaggerhub_get_owner_apisGet a list of APIs of the specified owner
swaggerhub_get_owner_domainsGet a list of domains of the specified owner
swaggerhub_get_private_settingsGet the visibility (public or private) of API version
swaggerhub_get_project_members_v2Get project members
swaggerhub_get_project_v2Get project information
swaggerhub_get_standardization_errorsRetrieve the standardization errors for a given API definition
swaggerhub_get_template_commentsReturn the list of comments for a template
swaggerhub_get_template_definitionRetrieve a template definition
swaggerhub_get_template_lifecycle_settingsRetrieve lifecycle settings for a template
swaggerhub_get_template_private_settingsRetrieve visibility settings for a template
swaggerhub_get_template_versionsRetrieve an APIs.json listing for all template versions for an owner and template
swaggerhub_get_templatesRetrieve a list of templates for an owner
swaggerhub_get_user_projectsGet all projects that a user has access to
swaggerhub_get_yaml_definitionGet the OpenAPI definition for the specified API version in YAML format
swaggerhub_patch_integrationPartially update integration settings
swaggerhub_rename_apiRename an API
swaggerhub_rename_domainRename a domain
swaggerhub_rename_templateRename a template
swaggerhub_save_definitionCreate or update an API
swaggerhub_save_domain_definitionCreate or update a domain
swaggerhub_save_project_v2Update a project
swaggerhub_save_template_definitionCreate or update a template
swaggerhub_search_apisSearch APIs
swaggerhub_search_apis_and_domainsRetrieve a list of currently defined APIs, domains, and templates in APIs.json format
swaggerhub_search_domainsSearch domains
swaggerhub_set_api_comment_status_v2Resolve or reopen a comment
swaggerhub_set_api_default_versionSet the default API version
swaggerhub_set_domain_comment_status_v2Resolve or reopen a comment
swaggerhub_set_domain_default_versionSet the default version for a domain
swaggerhub_set_domain_lifecycle_settingsPublish or unpublish a domain version
swaggerhub_set_domain_private_settingsSet the visibility (public or private) of a domain version
swaggerhub_set_lifecycle_settingsPublish or unpublish an API version
swaggerhub_set_private_settingsSet the visibility (public or private) of an API version
swaggerhub_set_template_lifecycle_settingsUpdate lifecycle settings for a template
swaggerhub_set_template_private_settingsUpdate visibility settings for a template
swaggerhub_update_api_comment_reply_v2Update a comment reply
swaggerhub_update_api_comment_v2Update a comment
swaggerhub_update_api_comments_v2Bulk update comments
swaggerhub_update_domain_comment_reply_v2Update a comment reply
swaggerhub_update_domain_comment_v2Update a comment
swaggerhub_update_domain_comments_v2Bulk update comments
swaggerhub_update_integrationUpdate integration settings
swaggerhub_update_project_members_v2Update a project’s members list
swaggerhub_update_template_commentsUpdate the list of comments for a template

swaggerhub_add_api_comment_reply_v2

Reply to a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
bodystringYesThe body value

swaggerhub_add_api_comment_v2

Add a new comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
bodystringYesThe body value
positionintegerYesThe position value
repliesobject[]NoThe replies value

swaggerhub_add_domain_comment_reply_v2

Reply to a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
bodystringYesThe body value

swaggerhub_add_domain_comment_v2

Add a new comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
bodystringYesThe body value
positionintegerYesThe position value
repliesobject[]NoThe replies value

swaggerhub_add_spec_to_project_v2

Add an API or domain to a project Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
projectIdstringYesProject name (case-sensitive)
specTypestringYesDefinition type - apis or domains.
namestringYesThe 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesThe version to clone (case-sensitive)
privatebooleanNoWhether the new version should be public (false) or private (true)

swaggerhub_clone_domain

Create a new domain version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesThe version to clone (case-sensitive)
privatebooleanNoWhether the new version should be public (false) or private (true)

swaggerhub_create_integration

Create an integration for the specified API and version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
bodyobjectYesCan 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
apisstring[]NoA list of APIs included in this project. The APIs must belong to the same owner as the project. API names are case-sensitive.
descriptionstringNoProject description
domainsstring[]NoA list of domains included in this project. The domains must belong to the same owner as the project. Domain names are case-sensitive.
namestringNoProject name

swaggerhub_delete_api

Delete an API Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)

swaggerhub_delete_api_comment_reply_v2

Delete a comment reply Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
replystringYesReply identifier

swaggerhub_delete_api_comment_v2

Delete a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier

swaggerhub_delete_api_version

Delete an API version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_delete_domain

Delete a domain Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
forcebooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
replystringYesReply identifier

swaggerhub_delete_domain_comment_v2

Delete a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier

swaggerhub_delete_domain_version

Delete a domain version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
forcebooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
integrationIdstringYesIntegration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations

swaggerhub_delete_project_v2

Delete a project Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
projectIdstringYesProject name (case-sensitive)

swaggerhub_delete_template

Delete a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier

swaggerhub_delete_template_version

Delete a particular version of a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier

swaggerhub_execute_integration

Run an integration Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
integrationIdstringYesIntegration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations
commitMessagestringNoCommit message for source control integrations

swaggerhub_fork_api

Fork an API Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
namestringYesThe 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.
privatebooleanNoWhether the forked version should be public (false) or private (true). If the value is not set, the original version’s setting will be used.
projectstringNoIf forking into an organization, you can optionally specify an existing project to add the forked definition to.

swaggerhub_fork_domain

Fork a domain Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
namestringYesThe 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.
privatebooleanNoWhether the forked version should be public (false) or private (true). If the value is not set, the original version’s setting will be used.
projectstringNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier
namestringYesThe 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.
privatebooleanNoWhether the forked version should be public (false) or private (true). If the value is not set, the original version’s setting will be used.
projectstringNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_api_default_version

Get the default version of an API Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)

swaggerhub_get_api_versions

Get a list of API versions Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)

swaggerhub_get_definition

Get the OpenAPI definition of the specified API version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
resolvedbooleanNoSet to true to get the resolved version of the API definition. The content of all external $refs will be included in the resulting file.
flattenbooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_domain_default_version

Get the default version of a domain Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)

swaggerhub_get_domain_definition

Get the OpenAPI definition of the specified domain version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_domain_json_definition

Get the OpenAPI definition for the specified domain version in JSON format Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_domain_lifecycle_settings

Get the published status for the specified domain and version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_domain_private_settings

Get the visibility (public or private) of a domain version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_domain_versions

Get a list of domain versions Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)

swaggerhub_get_domain_yaml_definition

Get the OpenAPI definition for the specified domain version in YAML format Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_integration_by_id

Get integration settings Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
integrationIdstringYesIntegration 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_json_definition

Get the OpenAPI definition for the specified API version in JSON format Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
resolvedbooleanNoSet to true to get the resolved version of the API definition. The content of all external $refs will be included in the resulting file.
flattenbooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_org_projects_v2

Get all projects of an organization Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
nameOnlybooleanNoReturn the project information excluding APIs and domains
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
orderstringNoSort order

swaggerhub_get_owner_apis

Get a list of APIs of the specified owner Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
sortstringNoSort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title
orderstringNoSort order

swaggerhub_get_owner_domains

Get a list of domains of the specified owner Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
sortstringNoSort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title
orderstringNoSort order

swaggerhub_get_private_settings

Get the visibility (public or private) of API version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier

swaggerhub_get_project_members_v2

Get project members Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
projectIdstringYesProject name (case-sensitive)

swaggerhub_get_project_v2

Get project information Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
projectIdstringYesProject name (case-sensitive)

swaggerhub_get_standardization_errors

Retrieve the standardization errors for a given API definition Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesThe api value
versionstringYesVersion identifier

swaggerhub_get_template_comments

Return the list of comments for a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier

swaggerhub_get_template_definition

Retrieve a template definition Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier
flattenbooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier

swaggerhub_get_template_private_settings

Retrieve visibility settings for a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier

swaggerhub_get_template_versions

Retrieve an APIs.json listing for all template versions for an owner and template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier

swaggerhub_get_templates

Retrieve a list of templates for an owner Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringNoOwner name

swaggerhub_get_user_projects

Get all projects that a user has access to Parameters:
ParameterTypeRequiredDefaultDescription
nameOnlybooleanNoReturn the project information excluding APIs and domains
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
sortstringNoSort criteria or result set: * NAME * OWNER
orderstringNoSort order

swaggerhub_get_yaml_definition

Get the OpenAPI definition for the specified API version in YAML format Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
resolvedbooleanNoSet to true to get the resolved version of the API definition. The content of all external $refs will be included in the resulting file.
flattenbooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
integrationIdstringYesIntegration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations
bodyobjectYesAn object that contains the integration parameters you want to update

swaggerhub_rename_api

Rename an API Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
newNamestringYesNew name

swaggerhub_rename_domain

Rename a domain Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
newNamestringYesNew name
forcebooleanNoIf 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
newNamestringYesNew name

swaggerhub_save_definition

Create or update an API Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner name (organization or user name, case-sensitive)
apistringYesAPI name (case-sensitive)
isPrivatebooleanNoWhether to make the API private (true) or public (false)
versionstringNoAPI 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).
forcebooleanNoForce update
bodystringYesOpenAPI 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
isPrivatebooleanNoSpecifies whether the domain has to be private
versionstringNoDomain version. If omitted, will be taken from the info.version field in the definition.
forcebooleanNoForce update
bodystringNoOpenAPI definition of this domain

swaggerhub_save_project_v2

Update a project Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
projectIdstringYesProject name (case-sensitive)
apisstring[]NoA list of APIs included in this project. The APIs must belong to the same owner as the project. API names are case-sensitive.
descriptionstringNoProject description
domainsstring[]NoA list of domains included in this project. The domains must belong to the same owner as the project. Domain names are case-sensitive.
namestringNoProject name

swaggerhub_save_template_definition

Create or update a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
isPrivatebooleanNoDefines whether the API or template has to be private
versionstringNoTemplate version to create or update. If omitted, the version will be taken from the info.version field in the definition.
forcebooleanNoForce update
projectNamestringNoThe project to add the API, domain, or template to
bodystringYesThe template definition

swaggerhub_search_apis

Search APIs Parameters:
ParameterTypeRequiredDefaultDescription
querystringNoFree text query to match
statestringNoMatches 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
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
sortstringNoSort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title
orderstringNoSort order

swaggerhub_search_apis_and_domains

Retrieve a list of currently defined APIs, domains, and templates in APIs.json format Parameters:
ParameterTypeRequiredDefaultDescription
specTypestringNoType of definitions to search: * API - APIs only * DOMAIN - domains only * TEMPLATE - templates only * ANY - APIs, domains, and templates
visibilitystringNoThe 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
statestringNoMatches 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
ownerstringNoAPI or domain owner. Can be username or organization name. Case-sensitive.
querystringNoFree text query to match
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
sortstringNoSort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title
orderstringNoSort order

swaggerhub_search_domains

Search domains Parameters:
ParameterTypeRequiredDefaultDescription
querystringNoFree text query to match
statestringNoMatches 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
pageintegerNoPage to return
limitintegerNoNumber of results per page (1 .. 100)
sortstringNoSort criteria of result set: * NAME * UPDATED * CREATED * OWNER * BEST_MATCH - by relevance * TITLE - by info.title
orderstringNoSort order

swaggerhub_set_api_comment_status_v2

Resolve or reopen a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
statusstringYesComment status

swaggerhub_set_api_default_version

Set the default API version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier (case-insensitive)

swaggerhub_set_domain_comment_status_v2

Resolve or reopen a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
statusstringYesComment status

swaggerhub_set_domain_default_version

Set the default version for a domain Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier (case-insensitive)

swaggerhub_set_domain_lifecycle_settings

Publish or unpublish a domain version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
forcebooleanNoTo publish a domain that references other unpublished domains, this parameter must be true. Otherwise, the request will be rejected with status code 424.
publishedbooleanNoWhether the definition is published (true) or unpublished (false)

swaggerhub_set_domain_private_settings

Set the visibility (public or private) of a domain version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
forcebooleanNoTo 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.
privatebooleanYesWhether the definition version is private (true) or public (false)

swaggerhub_set_lifecycle_settings

Publish or unpublish an API version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
forcebooleanNoTo publish an API that references unpublished domains, this parameter must be true. Otherwise, the request will be rejected with status code 424.
publishedbooleanNoWhether the definition is published (true) or unpublished (false)

swaggerhub_set_private_settings

Set the visibility (public or private) of an API version Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
privatebooleanYesWhether the definition version is private (true) or public (false)

swaggerhub_set_template_lifecycle_settings

Update lifecycle settings for a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier
forcebooleanNoForce update
publishedbooleanNoWhether the definition is published (true) or unpublished (false)

swaggerhub_set_template_private_settings

Update visibility settings for a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier
privatebooleanYesWhether the definition version is private (true) or public (false)

swaggerhub_update_api_comment_reply_v2

Update a comment reply Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
replystringYesReply identifier
bodystringNoThe body value

swaggerhub_update_api_comment_v2

Update a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
bodystringNoThe body value
positionintegerNoThe position value

swaggerhub_update_api_comments_v2

Bulk update comments Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
addCommentobject[]NoAdd Comment
addReplyobjectNoAdd Reply
deleteCommentstring[]NoDelete Comment
deleteReplyobjectNoDelete Reply
updateCommentobjectNoUpdate Comment
updateReplyobjectNoUpdate Reply
updateStatusobjectNoUpdate Status

swaggerhub_update_domain_comment_reply_v2

Update a comment reply Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
replystringYesReply identifier
bodystringNoThe body value

swaggerhub_update_domain_comment_v2

Update a comment Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
commentstringYesComment identifier
bodystringNoThe body value
positionintegerNoThe position value

swaggerhub_update_domain_comments_v2

Bulk update comments Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesDomain owner (organization or user, case-sensitive)
domainstringYesDomain name (case-sensitive)
versionstringYesVersion identifier
addCommentobject[]NoAdd Comment
addReplyobjectNoAdd Reply
deleteCommentstring[]NoDelete Comment
deleteReplyobjectNoDelete Reply
updateCommentobjectNoUpdate Comment
updateReplyobjectNoUpdate Reply
updateStatusobjectNoUpdate Status

swaggerhub_update_integration

Update integration settings Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI owner (organization or user, case-sensitive)
apistringYesAPI name (case-sensitive)
versionstringYesVersion identifier
integrationIdstringYesIntegration ID (case-sensitive). To get the available integration IDs, use GET /apis/{owner}/{api}/{version}/integrations
bodyobjectYesCan 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:
ParameterTypeRequiredDefaultDescription
ownerstringYesOrganization name (case-sensitive)
projectIdstringYesProject name (case-sensitive)
membersobject[]NoThe members value

swaggerhub_update_template_comments

Update the list of comments for a template Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesAPI, domain, or template owner identifier (case-sensitive)
templateIdstringYesTemplate identifier
versionstringYesVersion identifier
addCommentobject[]NoAdd Comment
addReplyobjectNoAdd Reply
deleteCommentstring[]NoDelete Comment
deleteReplyobjectNoDelete Reply
updateCommentobjectNoUpdate Comment
updateReplyobjectNoUpdate Reply
updateStatusobjectNoUpdate Status