Update SwaggerHub portal details when a release is ready
Make the portal update part of release momentum, not a separate task to remember later.
Trigger
Webhook received
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Action
Update Portal
Tool to update specific portal information in SwaggerHub. Use when you need to modify portal settings such as name, branding, subdomain, or other configuration options.
Why this helps
Release notes and portal changes are often handled in different moments, creating outdated customer guidance.
- More consistent release communication
- One fewer release checklist item
Setup
Build it in a few focused steps.
- 1Connect OneDesk and SwaggerHub to Notis once.
- 2Create an automation with an incoming release-ready webhook.
- 3Describe the portal information Notis should update and choose the channel for run reports.
Questions about this workflow
Can I review the automation prompt first?
Yes. The portal lets you edit the plain-language instruction before creating it.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link Onedesk to Swaggerhub. A trigger fires from one place; an action lands in another.
Onedesk triggers
Swaggerhub actions
Add Access Control for Teams
Tool to assign access control roles to teams on a SwaggerHub resource. Use when you need to grant team permissions (OWNER, DESIGNER, CONSUMER) for APIs, domains, projects, or portal products.
Add Access Control for Users
Tool to assign access control roles to users on a SwaggerHub resource. Use when you need to grant user permissions (owner, designer, consumer) for APIs, domains, projects, organizations, teams, or portal products.
Delete Table of Contents Entry
Tool to delete a table of contents entry from SwaggerHub portal. Use when you need to remove a table of contents entry by its ID. Optionally supports recursive deletion of nested entries.
Get Access Control Users
Tool to retrieve the list of users assigned access control on a SwaggerHub resource. Use when you need to check who has access to an API, domain, project, organization, team, or portal product.
Get API Default Version
Tool to get the default version identifier of a SwaggerHub API. Use when you need to know which version is marked as default for an API. This returns only the version identifier; to get the full API definition, use the version with GET /apis/{owner}/{api}/{version}.
Get API Versions
Tool to retrieve a list of API versions for a specific API in SwaggerHub. Use when you need to get all versions of an API owned by an organization or user. Returns 404 if the specified API is not found or if the authenticated user does not have access to a private API.
Get Consumer Products
Tool to get a list of products that are visible to the consumer in a SwaggerHub portal. Use when you need to retrieve products from a portal, including both accessible and inaccessible products. This endpoint does not require authentication.
Get API Definition
Tool to get the OpenAPI definition of a specified API version from SwaggerHub. Use when you need to retrieve the complete API specification including endpoints, schemas, and documentation for a specific API version.
Connect any two apps with Notis in the middle.
Not just Onedesk and Swaggerhub. Any combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7 days free trial with 20$ free usage included.
No card. Works with personal or business Swaggerhub.