Skip to main content
To obtain an authorization token for the use of the Enneo API, API users have the following options, depending on the use case.

1. User-JWT-Token for development

Users can generate a personal access token by navigating to their profile page and clicking on the “Create API Key” button. It is important to save this key, as it will only be displayed once.

2. Service Worker JWT-Token for periodic tasks

A Service Worker token can be used by selecting an existing Service Worker or creating a new one in the settings → Users → Service Worker. Once a Service Worker is chosen, users can generate an API key by clicking on the “Create API Key” button. It is crucial to save this key, as it will only be displayed once. These tokens will only expire if they are revoked or recreated on the Users → Service Worker page.

3. OAuth2 Session Token

API Service Workers or users can log in with Single-Sign-On (SSO) credentials via the /api/auth endpoints to obtain a session token. The SSO backend, typically Microsoft Azure OAuth2 or Google OAuth2, then validates against Enneo. If the validation is successful, Enneo issues a session token valid for 24 hours that can be used as access data for API requests. This method is more complex and is typically used only in advanced infrastructure setups.
Within AI functions, it is not required to authorize against the Enneo API endpoints. The SDK takes over the authorization.
Remember to securely store and manage your authorization tokens to ensure the security and integrity of your API interactions.

Using the Token

Once you have the token, it can be passed as a Bearer token in the header, as in this example:
curl --header 'Authorization: Bearer eyJhbGciOiJI...' \
     'https://demo.enneo.ai/api/mind/ticket/6'