Bosch IoT Rollouts

SOUP API Reference

Table of contents:

You can access the System Software Update API Swagger docs at https://system-management.eu1.bosch-iot-rollouts.com/swagger-ui/index.html.

SOUP API Overview

The System Software Updates API is a RESTful API that enables to perform Create/Read/Delete operations for SOUP-related resources such as tags, systems, or recipes etc.

The APIs supports JSON payload with Hypermedia. You can traverse across resources via cursor based pagination. Furthermore the Management API provides role based access control based on standard roles.

The System Software Updates API is split into two sections, depending on the use case.

Management API

The Management API is an user-facing API for managing and listing content. It allows you to:

  • READ and DELETE systems

  • READ and DELETE modules

  • READ, CREATE and DELETE recipes

  • READ and CREATE recipe-tags

  • READ, CREATE and DELETE recipe signatures

  • Trigger recipe validation

  • Traverse through recipe lifecycle

Install API

The Install API is a device facing API exposing recipes and software to be installed on systems. It allows the device to:

  • READ recipes

  • CREATE system reports

  • CREATE update reports

  • READ software artifacts

  • READ tags

Service API

The Service API is a user-facing API for retrieving information about the service itself. It allows you to:

  • READ service version

  • READ change-log