Skip to main content
All API requests require authentication using either:
  • Organization API Keys - Created by Organization Admins in Settings > API Keys
  • Personal Access Tokens (PAT) - User-scoped tokens created in a user’s profile settings
Include your token in the Authorization header as: Bearer YOUR_API_KEY: 
curl -L 'https://blobsrus.omniapp.co/api/scim/v2/users' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <YOUR_API_KEY>'

​
Organization API keys

Organization Admin permissions are required to create and access organization API keys.
To create an API key:
1
Navigate to Settings > API Keys.
2
Click Generate new key.
3
In the modal that displays, enter a descriptive name for the API key.Note: API keys will inherit the user attributes of the user who created the key. Enter something that distinguishes you as the creator, such as your initials, into the key’s Name field to make it easy to identify who created the key. This can be helpful when troubleshooting permission issues.
4
Click Generate.
5
Copy the key. Note: API keys are only displayed once when created.

​
API key expiration

API keys do not expire, but they may be revoked by the user at any time. In the event that your API key is lost or compromised, delete the API key in your Omni instance and create a new one.

​
Personal Access Tokens (PAT)

Personal access tokens (PAT) allow individual users to use the Omni API with their own permissions, rather than using an organization API key. PATs are scoped to the user who creates them and respect that user’s access.
PATs cannot be used for authentication with the following endpoints, as an Organization API key is required:

​
Creating PATs

1

Enable Personal Tokens for your Omni instance

First, an Organization Admin has to enable the Settings > API Access > Personal tokens setting. This allows users in the instance to create PATs.
2

Generate a token

Once enabled, users with Modeler or Connection Admin permissions on any model in the instance can create a personal token.Click your Omni user profile icon, then Manage account > Generate token.