---
title: "Swaggerhub integration for LuumenAI"
url: "https://www.luumen.ai/integrations/swaggerhub/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Swaggerhub integration for LuumenAI

Read API definitions and versions, then change access with approval

## What LuumenAI can do with Swaggerhub

LuumenAI connects to Swaggerhub with an API token and exposes 44 tools (35 read-only · 5 write · 4 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 44 tools (35 read-only · 5 write · 4 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Source control & CI/CD

## About Swaggerhub with LuumenAI

Connect Swaggerhub and your agent can read the things you normally open a browser tab for: API and domain versions, the default version, the OpenAPI definition behind a given version, and who currently holds access on a resource. When something needs to change, like granting a team read access before a review, the agent shows the call first and waits for your approval. Authentication is by API key.

## Example tools

Read-only (35 in total):

- `SWAGGERHUB_GET_ACCESS_CONTROL_USERS` — Retrieve the list of users assigned access control on a SwaggerHub resource.
- `SWAGGERHUB_GET_API_DEFAULT_VERSION` — Get the default version identifier of a SwaggerHub API.
- `SWAGGERHUB_GET_API_VERSIONS` — Retrieve a list of API versions for a specific API in SwaggerHub.
- `SWAGGERHUB_GET_CONSUMER_PRODUCTS` — Get a list of products that are visible to the consumer in a SwaggerHub portal.
- `SWAGGERHUB_GET_DEFINITION` — Get the OpenAPI definition of a specified API version from SwaggerHub.
- `SWAGGERHUB_GET_DOMAIN_DEFAULT_VERSION` — Retrieve the default version identifier of a SwaggerHub domain.
- `SWAGGERHUB_GET_DOMAIN_DEFINITION` — Retrieve the OpenAPI definition of a specified domain version from SwaggerHub.
- `SWAGGERHUB_GET_DOMAIN_JSON_DEFINITION` — Retrieve the OpenAPI definition for a specified domain version in JSON format.

Write and destructive (9 in total, subject to configured approval policy):

- `SWAGGERHUB_ADD_ACCESS_CONTROL_FOR_TEAMS` — Assign access control roles to teams on a SwaggerHub resource.
- `SWAGGERHUB_ADD_ACCESS_CONTROL_FOR_USERS` — Assign access control roles to users on a SwaggerHub resource.
- `SWAGGERHUB_DELETE_TABLE_OF_CONTENTS_ENTRY` — Delete a table of contents entry from SwaggerHub portal.
- `SWAGGERHUB_REMOVE_ACCESS_CONTROL_FOR_TEAMS` — Remove access control for teams from a SwaggerHub resource.
- `SWAGGERHUB_REMOVE_ACCESS_CONTROL_FOR_USERS` — Remove access control for users from a SwaggerHub organizational resource.
- `SWAGGERHUB_REMOVE_MEMBERS` — Remove members from a SwaggerHub organization.
- `SWAGGERHUB_UPDATE_ACCESS_CONTROL_FOR_TEAMS` — Update access control roles for teams on a SwaggerHub resource.
- `SWAGGERHUB_UPDATE_ACCESS_CONTROL_FOR_USERS` — Update access control roles for users on a SwaggerHub resource.

## Frequently asked questions

### How does LuumenAI connect to Swaggerhub?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Swaggerhub on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Swaggerhub — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/swaggerhub/