Skip to Main Content
Cumulocity IoT Feedback Portal
Status Added/Resolved 🎉
Created by Alexander Pester
Created on Aug 17, 2020

REST API Developer support

Proposal Idea

Often times while working on Cumulocity microservice which makes use of the Cumulocity platform API there is a need to be aware of the existing APIs that can be leveraged, signature of the APIs i.e. request object it takes and the returned response object. Also during the unit testing at time there is a need to invoke these platform APIs to trigger or test a microservice or some module.

To achieve this Postman is often used where first the Cumulocity API collections are to be imported and then global variables are set and API then return response only after proper authorization.


The objective of this idea is to make the usage of Cumulocity platform APIs lot more user friendly for usage in any phase of microservice development lifecycle.

  • The provision has to be made in c8y portal which showcases all the existing APIs and their descriptions.

  • The support to add sample input and output signature for all the APIs

  • The Try Me feature where user can execute the API with the input (request body or input parameters) of his choice

  • A feature to save the API calls with custom body or param for future use

  • A feature to export all or selected APIs as Postman collection

  • A feature to deploy the APIs to any other Cumulocity tenant

Idea posted by Faraz Khalid at "Pitch your Idea! GCC IoT


Axonize IoT platform (competitor) provides a Swagger UI for complete REST API, which was used a lot of T-Systems. After the migration to Cumulocity they have lost this feature, they have to use postman collection.

  • Attach files
  • Admin
    Nikolaus Neuerburg
    Mar 10, 2023

    The Open API documentation for Cumulocity IoT is available here:

  • Admin
    Nikolaus Neuerburg
    Sep 3, 2020

    Thanks for the feedback Alexander. Currently, we are working on migrating our API / Reference documentation to the Open API format to implement the objectives that you mentioned. We are looking to release this in a first version in January.


Create an interactive REST API portal

PTC has this and it works great This was originally requested by Alexander Pester from the Center of excellence team of Stephan Buchholz.
Guest almost 4 years ago in Cumulocity IoT 1 Added/Resolved 🎉