# IBM API Connect Discovery API

**Canonical:** https://apis.io/apis/ibm-api-connect/ibm-api-connect-discovery-api/  
**Provider:** IBM API Connect — https://apis.io/providers/ibm-api-connect/  
**Base URL:** https://{discovery-endpoint}/discovery  
**Documentation:** https://apic-api.apiconnect.ibmcloud.com/v12/

IBM API Connect Discovery API is one of 43 APIs that [IBM API Connect](https://apis.io/providers/ibm-api-connect/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include API Discovery, Governance, and REST API. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, and authentication docs.

Processes API call records collected from gateways and proxies to discover APIs that are not yet managed in API Connect. OpenAPI 3.0, version 2.0.0.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/orgs/{org}/discovered-apis` | Create a Discovered API object |
| GET | `/orgs/{org}/discovered-apis` | List all Discovered API objects in all collections |
| DELETE | `/orgs/{org}/discovered-apis` | Clear all Discovered API objects in all collections |
| GET | `/orgs/{org}/discovered-apis/{discovered-api-name}` | List the Discovered API objects |
| DELETE | `/orgs/{org}/discovered-apis/{discovered-api-name}` | Clear the Discovered API objects |
| GET | `/orgs/{org}/discovered-apis/{discovered-api-id}` | Get the Discovered API object by id |
| PATCH | `/orgs/{org}/discovered-apis/{discovered-api-id}` | Update the Discovered API object by id |
| DELETE | `/orgs/{org}/discovered-apis/{discovered-api-id}` | Delete the Discovered API object by id |
| GET | `/orgs/{org}/discovered-apis/{discovered-api-name}/{discovered-api-version}` | Get the Discovered API object by name and version |
| PATCH | `/orgs/{org}/discovered-apis/{discovered-api-name}/{discovered-api-version}` | Update the Discovered API object by name and version |
| DELETE | `/orgs/{org}/discovered-apis/{discovered-api-name}/{discovered-api-version}` | Delete a Discovered API |
| PUT | `/orgs/{org}/discovered-apis/{discovered-api-id}/promote` | Copy a Discovered API to API Manager as a Draft API |
| PUT | `/orgs/{org}/discovered-apis/{discovered-api-name}/{discovered-api-version}/promote` | Copy a Discovered API to API Manager as a Draft API by name and version |
| POST | `/orgs/{org}/discovered-apis/bulk` | Create Discovered API objects from a zip file |
| DELETE | `/orgs/{org}/discovered-apis/bulk/delete` | Bulk Delete Discovered APIs by id |
| PATCH | `/orgs/{org}/discovered-apis/bulk/hide` | Bulk Hide/Unhide Discovered APIs by id |
| GET | `/orgs/{org}/discovered-apis/filters` | Get filters for Discovered APIs |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ibm-api-connect/refs/heads/main/openapi/ibm-api-connect-discovery-api-openapi.yml
- **Reference** — https://apic-api.apiconnect.ibmcloud.com/v12/
- **Documentation** — https://www.ibm.com/docs/en/api-connect/software/12.1.1?topic=reference-api-connect-rest-apis
- **GettingStarted** — https://www.ibm.com/docs/en/api-connect/software/12.1.1?topic=reference-api-connect-rest-apis
- **Authentication** — https://www.ibm.com/docs/en/api-connect/software/12.1.1?topic=cli-managing-platform-rest-api-keys

## Other IBM API Connect APIs (12)

- [IBM API Connect Platform - Cloud Management API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-cloud-management-api/)
- [IBM API Connect Analytics API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-analytics-api/)
- [IBM API Connect Consumer Analytics API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-consumer-analytics-api/)
- [IBM API Connect Engagement API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-engagement-api/)
- [IBM API Connect AI Assets API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-ai-assets-api/)
- [IBM API Connect Application Strategy management API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-application-strategy-management-api/)
- [IBM API Connect Billing Management API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-billing-management-api/)
- [IBM API Connect Catalog Management API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-catalog-management-api/)
- [IBM API Connect Catalog Resource API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-catalog-resource-api/)
- [IBM API Connect Catalog Resources API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-catalog-resources-api/)
- [IBM API Connect Catalog Settings API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-catalog-settings-api/)
- [IBM API Connect Cloud Settings API](https://apis.io/apis/ibm-api-connect/ibm-api-connect-cloud-settings-api/)

## Tags

API Discovery, Governance, REST API

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ibm-api-connect/ibm-api-connect-discovery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ibm-api-connect/.