API Keys

Users can generate a variety of API keys for interacting with Multitudes via API.

Types of keys

API keys come in 2 types: Personal API keys and Organization API keys.

Personal API keys

These keys are used when sending OTel metrics from tools like Claude Code to the Multitudes OTel collector. They are personal to each engineer, so they pose less risk if compromised.

Organization API keys

These keys are for performing activities on behalf of an organization, including: posting deployment metrics to the Deployments API, querying the Multitudes API, or sending OTel data from a central collector to Multitudes (rather than directly from an engineer's machine).

Permissions needed to generate a key

Key type	Scopes	Purpose	Permissions to generate
Personal	Open Telemetry: write	Sending raw OTel data from an individual's machine direct to Multitudes	Members, Managers, and Owners
Organization	Open Telemetry: write	Sending aggregated OTel data from multiple engineers machines to Multitudes via a centralized collector	Managers and Owners
Organization	Deployments: write	Sending deployments to the Deployments API	Managers and Owners
Organization	Data: read	Querying the Multitudes API	Members, Managers, and Owners

Generating an API Key

1. From the Settings > API Keys page, click "+ Generate New Key" on the top right corner of the page. This will pop-up a modal.

1. In the modal, select your key type. Choose a Personal or Organization key based on your usecase.

2. Select the appropriate scopes for your use case. Scopes can be set to no access, read, or write

3. Click "Create key".

1. After the key has been generated, copy it for use. The full key will only be shown once.