Leveraging the API
Rumble provides three primary APIs as well as integration-specific endpoints:
- The Export API provides read-only access to a specific organizations.
- The Organization API provides read-write access to a specific organizations.
- The Account API provides read-write access to all account settings and organizations.
To get started, you will need an export token or API key. Export API tokens and Organization API keys can be generated by going to the Organizations section in the Rumble web console, clicking on the appropriate organization name, and scrolling down to the export token or API keys section. A button there will let you generate a secure API key, in the form of a long random token. You must have administrator access to generate API keys.
Account API keys are generated from the Accounts settings page. Note that the Account API requires an Enterprise license.
Once you have generated a token, your REST client should use it with the
Authorization: Bearer standard header to authenticate.
To use an Account API key with the Organization API, specify the additional parameter
_oid=[organization-id] in the query parameters.