AssetIT

API Credentials

The API Credentials in AssetIT allow administrators to securely integrate AssetIT with external systems using REST APIs.

For full API usage details, refer to the official documentation: API Documentation.

Important Note:

Please ensure that you use the correct API documentation URL based on your data residency. The base URL will vary depending on your region:

Managing API Credentials:

To manage credentials:

  • Go to ⚙️ Settings > image-20250708-072955.png

image-20250708-072411.png
  • You'll see a list of existing credentials, showing:

    • Owner – User who generated the key

    • Client ID – Public identifier used in authentication

    • Client Secret – Private key (hidden by default)

    • Created At / Updated At – For tracking and auditing

    • Actions – Options such as regenerate and delete

Each user can only generate 1 API key for a single instance. In case of need for a new API key for another instance, please remove the existing one.

Deploying Your API Credentials:

  • Step 1: After creating the API key in AssetIT, copy the ID and passcode.

  • Step 2: Navigate to the Authentication section of the API documentation.

image-20240321-072409.png
Click on the Authentication section
  • Step 3: Click “Try it out” in the Authentication section

Screenshot 2024-03-21 at 2.22.14 PM.png
  • Step 4: Input the previously copied ID and passcode, then click Execute.

Screenshot 2024-03-21 at 2.29.37 PM.png
  • Step 5: After executing step 2, the system will provide an Authentication Token as a response.

Screenshot 2024-03-21 at 14.21.42 (1).png
  • Step 6: Copy the token and paste it to the Authorize button or any locker icon as per your reference.

Screenshot 2024-03-21 at 2.30.38 PM.png
  • Step 7: It's crucial to prepend the token with "JWT " (including a space after JWT) to activate its functionality properly. Click Authorize to finish.

image-20240321-073213.png

Exclusive Admin Rights: Only administrators have the authority to create and manage API credentials.