# Swaggerhub AI integration on Definable

> Accelerating API delivery and quality through standards and collaboration, built on OpenAPI

## What this connects

Accelerating API delivery and quality through standards and collaboration, built on OpenAPI

Vendor: https://swagger.io/tools/swaggerhub/

## Tools available

**44** tools available. First 12:

- `SWAGGERHUB_ADD_ACCESS_CONTROL_FOR_TEAMS` — 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.
- `SWAGGERHUB_ADD_ACCESS_CONTROL_FOR_USERS` — 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.
- `SWAGGERHUB_DELETE_TABLE_OF_CONTENTS_ENTRY` — 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.
- `SWAGGERHUB_GET_ACCESS_CONTROL_USERS` — 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.
- `SWAGGERHUB_GET_API_DEFAULT_VERSION` — 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}.
- `SWAGGERHUB_GET_API_VERSIONS` — 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.
- `SWAGGERHUB_GET_CONSUMER_PRODUCTS` — 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.
- `SWAGGERHUB_GET_DEFINITION` — 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.
- `SWAGGERHUB_GET_DOMAIN_DEFAULT_VERSION` — Get Domain Default Version — Tool to retrieve the default version identifier of a SwaggerHub domain. Use when you need to know which version is set as default for a domain before fetching its definition.
- `SWAGGERHUB_GET_DOMAIN_DEFINITION` — Get domain definition — Tool to retrieve the OpenAPI definition of a specified domain version from SwaggerHub. Use when you need to access reusable domain components, schemas, or parameters.
- `SWAGGERHUB_GET_DOMAIN_JSON_DEFINITION` — Get Domain JSON Definition — Tool to retrieve the OpenAPI definition for a specified domain version in JSON format. Use when you need to access the domain definition document from SwaggerHub.
- `SWAGGERHUB_GET_DOMAIN_LIFECYCLE_SETTINGS` — Get Domain Lifecycle Settings — Tool to get the published status for a specific domain and version in SwaggerHub. Use when you need to check if a domain version is published or unpublished.

## Auth

Auth schemes: `API_KEY`.

## How agents use Swaggerhub

Inside a Definable workflow, Swaggerhub is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Swaggerhub** — the Researcher (GPT-5.5) pulls context from Swaggerhub (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Swaggerhub** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Swaggerhub (create record, post message, draft email).
- **Designer / Engineer → Distributor → Swaggerhub** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Swaggerhub (attach file, open PR comment, post status).

The Verifier checks every Swaggerhub call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/swaggerhub/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt