Using the REST API Key

the rest api key created for a tenant is used for authorizing rest api endpoints these keys are static and do not change or expire, unlike session ids creating a rest api key group when using this feature for the first time, you need to create a group for rest api if it already exists, then you can skip this step and proceed to create a rest api key docid\ uaqtdeghj3ebw29q0gop8 from the , click configure > security controls > api keys click add key group the application displays the new api group page enter a contextual name and description for the group in the name and description fields click save key group a rest api group is created click back to return to the api keys page creating a rest api key from the , click configure > security controls > api keys select the relevant group created for rest api from the key groups section rest api group click add api key the application displays the new api key page enter information into the fields reference id this field is auto generated this id is the rest api key you need to use for endpoint authorization activated select or clear the check box to activate and deactivate the key description enter a description for the key on behalf of select the name of the user creating the key in role select the role of the user creating the key by default, the rest api key created is applicable for the logged in tenant however, you can add additional ips to this key to do so, click add new ip , enter the ip address and click ok click save key the generated rest api key is saved with the details you entered click back to return to the api keys page editing a rest api key from the , click configure > security controls > api keys select the relevant group for rest api from the key groups section the application displays the list of available keys find the key and click edit modify the details as required and click save key deleting a rest api key from the , click configure > security controls > api keys select the relevant group for rest api from the key groups section the application displays the list of available keys find the key and click delete using the rest api key to use the rest api key as authorization when executing an endpoint create a new request in the postman application enter the following information in the header tab select the authorization check box enter the reference id (rest api key) generated for the tenant in the value column in the format rest api key={reference id} in the same endpoint request window, enter the endpoint request payload details and click the send button or press the enter key when executing rest apis from a tenant, the rest api key generated for the same tenant can only be used and not of any other tenant for example, rest api key generated for tenant#x cannot be used for executing apis from tenant#y troubleshooting rest api key when you execute a rest api endpoint, you get a not authorized error reason the rest api key used to authorize the endpoint does not belong to this tenant/ip solution create a new rest api key for this tenant/ip see creating a rest api key docid\ uaqtdeghj3ebw29q0gop8