Skip to main content

Authentication

To authenticate API requests, you'll need to create an API key from OlmoEarth Studio.

Creating an API Key​

  1. Log into OlmoEarth Studio
  2. Click the menu icon in the top right corner and select My Profile
  3. In the API Keys section, click Create new API key
  4. Enter a descriptive name for your key (e.g., "Production CI/CD" or "Local Development")
  5. Click Create
  6. Copy your API key immediately using the copy button
warning

Store your API key securely. The full key is only shown once at creation. If you lose it, you'll need to create a new one.

Using Your API Key​

Include the API key in the Authorization header as a bearer token:

curl -H "Authorization: Bearer YOUR_API_KEY"  "https://olmoearth.allenai.org/api/v1/..."

If you're using the Interactive OlmoEarth API Browser, paste your API key in the Authentication box to make requests directly.

Managing API Keys​

From your profile page, you can:

  • View all your keys - See key names, creation dates, and last used timestamps
  • Rename keys - Update the name to keep your keys organized
  • Delete keys - Permanently revoke a key (applications using it will stop working)

You can create up to 10 API keys per account.

tip

Use separate API keys for different applications or environments. This makes it easy to rotate or revoke access without affecting other integrations.

tip

OlmoEarth API Endpoints

OlmoEarth API endpoints are documented in the Interactive OlmoEarth API Browser.

You can use it to understand request and response schemas, make requests directly to the API, and generate client code in many common languages and libraries.