Authenticate in the API Reference Documentation

Momentus Connect API reference documentation is in Swagger format, where you can browse endpoints and make real API calls directly from the browser. This allows you to: 

• Test endpoints live against your actual database without needing a separate tool like Postman.
• See real responses based on your data and permissions.
• Explore and validate how the API behaves before writing any integration code.

To make API calls you must authenticate in the documentation site. You will need your account subscription key and the credential's Access or API Token, which are found on the main Momentus Connect site. Go to the Momentus Connect API page and select the Configuration tab.

• Subscription Key: The account-wide subscription key can be found on the Momentus Connect API page in the header. Click the copy icon to copy it to your clipboard.
• Access Token (OAuth) or API Token: On the Momentus Connect API page, go to the Configuration tab and find the credential in the list. Click the eye icon to open a pop up with the token. Click the copy icon to copy it to your clipboard.

Follow the directions below for the type of authentication credentials you are using.

API Token (Elite or Enterprise)

1. Click Authentication in the left navigation. 
2. Add your credentials in each field:
   1. API Key (Ocp-Apim-Subscription-Key): Add the subscription key and click Set.
   2. API Key (Authorization): Leave this field empty.
   3. API Key (ApiToken): Add your API token and click Set.

OAuth (Enterprise only)

1. Click Authentication in the left navigation. 
2. Add your credentials in each field:
   1. API Key (Ocp-Apim-Subscription-Key): Add the subscription key and click Set.
   2. API Key (Authorization): Add your access token and click Set.
   3. API Key (ApiToken): Leave this field empty.

Tenant Details

When accessing the API Reference from the Momentus Connect dashboard or Marketplace, the Tenant Details (which determine where API requests are sent) are automatically pre-configured. You do not set these manually. 

If you access the API Reference Docs from a direct link (such as those in Momentus API Reference Documentation), you will not be able to add Tenant Details.

Make a Test Request

Once you have configured your authentication, you can make a test request.

1. Select an endpoint from the menu on the left.
2. Fill in any required parameters for the endpoint.
3. Click Test Request. The response will appear in the Response section below, including any errors that may need to be corrected.