Published REST Services

Last update: Download PDF Edit

1 Introduction

Add a published REST service to expose your entities and microflows to other apps using the REST standard.

2 Published REST Service

For an overview of the available options when you add a published service, see Published REST Service.

You can easily expose an entity via REST by right-clicking the entity in the domain model and selecting Expose as REST resource.

To publish a microflow as a REST operation, right-click anywhere in the editor and select Publish as REST service operation.

3 Authentication

Published REST services are secured with basic authentication. This is automatically applied when you set the security level of your app to Prototype / demo or Production.

If you don’t want basic authentication, there are two options:

  • You can choose to have no authentication for specific published REST services, or
  • When you allow anonymous users to your app, all published REST services become available without authentication

For more details, see Published REST Routing and section 3.1 Requires Authentication in Published REST Service.

4 Documentation

Every published REST service is automatically documented. This documentation is available in the app under Each service has an interactive documentation page using Swagger UI. You can interact with the service to see how it behaves.

The documentation of the services is available in the Open API 2.0 format, which is readable by many systems and tools. It contains JSON Schemas for the messages definitions.

5 Logging

To log detailed information about interaction with your published REST service, set the log level of the REST Publish log node to Trace.

6 Example

How to publish REST natively with Mendix