API Documentation

OpenAPI Specification

Portrait provides a REST API which is documented via an OpenAPI Specification.
To retrieve the spec of your instance call:
https://portrait.customer.xyz/v3/api-docs

This will return a JSON formatted OpenAPI Specification, which can be used for example to create a Request Collection in Postman or Insomnia

Also, see the Guide for Working with Postman

The OpenAPI Specification is not guaranteed to be stable throughout the different versions (Major, Minor and Hotfix).
Be sure to update the specification in your rest client (postman, …) after you update Portrait!

API User Interface

In addition to the raw JSON OpenAPI specification, we also provide a practical UI to view and access the API in the browser.

To access the API documentation, open the following site:
https://portrait.customer.xyz/api-docs
In case the forwarding does not work try https://portrait.customer.xyz/swagger-ui/index.html

This should bring you to the following site:

Swagger-UI Interface which is integrated without Portrait

Most API Calls require Authentification (see the lock on the right). To authenticate click “Authorize on the top right.

Here you have to provide your Portrait Login (email+password)

Authorization Popup - leave client_id and client_secret empty

Afterward you should be able to call the API Methods via the try out button.