# Rillet Connection Guide

## Prerequisites

- A Rillet account with admin access to Organization Settings
- API access enabled by Rillet (contact your Rillet team if not yet activated): this is not self-service, so it's worth starting this step early

## Getting Your API Key

1. Log in to your Rillet account
2. Navigate to **Organization Settings > API Access**
   - Production: `https://app.rillet.io/settings/api-access`
   - Sandbox: use the same Organization Settings > API Access screen in your sandbox environment (Rillet does not publish a separate sandbox portal URL: ask your Rillet contact if you can't find it)
3. Click **Create API Key**
4. Copy the generated API key: it is shown only once

## Connecting via Apideck Vault

1. Select **Rillet** from the connector list
2. Choose your environment:
   - **Production**: connects to `https://api.rillet.com`
   - **Sandbox**: connects to `https://sandbox.api.rillet.com`
3. Paste your API key in the **API Key** field
4. Click **Save** to establish the connection

## Notes

- API keys are scoped to a single Rillet organization and presented as a Bearer token, not OAuth
- Sandbox and production API keys are separate and cannot be used against each other. Choose the matching environment when you create the connection: a key and environment that disagree will simply fail to authenticate, and the environment can't be changed later without reconnecting
- The connector sets the Rillet API version automatically: no action needed
- If requests start failing with HTTP 429, you have hit Rillet's rate limit. Back off and retry; see [Rillet's API documentation](https://docs.api.rillet.com) for the current threshold and how to raise it