Skip to Main Content
IBM Cloud - Structured Ideas


This portal is to open public enhancement requests against IBM Cloud and its products. To view all of your ideas submitted to IBM, create and manage groups of Ideas, or create an idea explicitly set to be either visible by all (public) or visible only to you and IBM (private), use the IBM Unified Ideas Portal (https://ideas.ibm.com).


Shape the future of IBM!

We invite you to shape the future of IBM, including product roadmaps, by submitting ideas that matter to you the most. Here's how it works:

Search existing ideas

Start by searching and reviewing ideas and requests to enhance a product or service. Take a look at ideas others have posted, and add a comment, vote, or subscribe to updates on them if they matter to you. If you can't find what you are looking for,

Post your ideas
  1. Post an idea.

  2. Get feedback from the IBM team and other customers to refine your idea.

  3. Follow the idea through the IBM Ideas process.


Specific links you will want to bookmark for future use

Welcome to the IBM Ideas Portal (https://www.ibm.com/ideas) - Use this site to find out additional information and details about the IBM Ideas process and statuses.

IBM Unified Ideas Portal (https://ideas.ibm.com) - Use this site to view all of your ideas, create new ideas for any IBM product, or search for ideas across all of IBM.

IBM Cloud Support Center (https://cloud.ibm.com/unifiedsupport/cases/form) – Use this site for any IBM Cloud defect or support need.

Stack Overflow (https://stackoverflow.com/questions/tagged/ibm-cloud) – Use this site for IBM Cloud technical Q&A using the tag "ibm-cloud".

ideasibm@us.ibm.com - Use this email to suggest enhancements to the Ideas process or request help from IBM for submitting your Ideas.

Status Future consideration
Categories Documentation
Created by Guest
Created on Aug 25, 2022

OpenAPI definitions for all IBM Cloud services should be publicly available

https://cloud.ibm.com/docs?tab=api-docs Current OpenAPI definitions for IBM Cloud services are available at above page.


Customers do not have access to collated GITHUB Repo where IBM Cloud maintains OpenAPI definition of all IBM CLoud services.

https://github.ibm.com/cloud-api-docs


If we do not have access to this repository, it becomes extremely difficult to maintain OpenAPI definition versioning. We do not have any way to determine what was the earlier version for specific services and what is the new one.


All other CSPs provide access to there OpenAPI defintions. Examples are provided below.


All other CSPs do provided access to their repos publicly.


Azure -->
https://github.com/Azure/azure-rest-api-specs

AWS --> https://github.com/aws/aws-sdk-java-v2

OCI --> https://docs.oracle.com/en-us/iaas/api/specs/index.json

GCP -> https://www.googleapis.com/discovery/v1/apis









Idea priority Urgent
Needed By Week
  • Guest
    Reply
    |
    Aug 25, 2022

    I know that OpenAPI definitions are publicly available on individual pages and we can download it. In this case we need to crawl through every page and download the OpenAPI definition for every IBM Cloud service.



    But this does not work for us, we need one collated GITHUB repo where all OpenAPI definitions are available and we can track version history of every OpenAPI definition.

    All other CSPs do provide access to their OpenAPI specs publically.

  • Admin
    Jenifer Schlotfeldt
    Reply
    |
    Aug 25, 2022

    Thanks for posting a new idea! Most services do make their OpenAPI definition file available for download through the API Reference. To find out if it is available, go the API Reference and click the menu next to the title of the reference in the left navigation. (See attached screenshot)