Skip to main content
Ringg API requests use a workspace API key in the X-API-KEY header.
Treat the API key as a server-side secret. Do not include it in browser JavaScript, mobile app bundles, public repositories, screenshots, logs, or support tickets.

Get your API key

  1. Log in to the Ringg AI dashboard.
  2. Open API from the dashboard sidebar.
  3. Copy the workspace API key, or regenerate it if you intentionally want to rotate the key.
Ringg dashboard API key screen

X-API-KEY

Regenerating an API key immediately invalidates the previous key. Update every backend service that uses the old key before relying on the new one.

Send the API key

Successful response

GET /workspace is the simplest authentication check.

Production practices

  • Store the key in a secret manager or environment variable.
  • Use one backend service as the integration boundary when possible.
  • Rotate the key if you suspect it’s been exposed.
  • Avoid logging request headers.
  • Alert on unexpected usage volume or repeated 401 responses.
  • Use HTTPS for every API call.

Troubleshooting

Next steps

Quick Start Guide

Use the key to make your first call.

Regenerate API Key

Rotate a workspace key intentionally.