Skip to main content

Step 1: Access Your Dashboard

Log into your Tinfoil account and click the “Dashboard” button in the top right corner. Use the account switcher in the top right corner to select “Personal account” to create a key for your personal account, or select an organization to create an organization key. You must be an admin of the selected organization; the Admin Keys tab is hidden for other members. Membership in an organization does not prevent you from creating personal keys in your personal account.

Step 2: Navigate to the Admin Keys tab

Select “Admin Keys” in the dashboard sidebar to access the admin key management page. Admin-key creation does not require active API billing. Creating inference keys with an admin key still requires active token billing for its account.

Step 3: Name Your Admin Key

Click “Create admin key” and enter a name in the “Name” field. The dialog identifies the personal account or organization that the key will belong to. Expand “Advanced options” to restrict the key to specific actions or containers. See Scoped admin keys for details.

Step 4: Create Admin Key

Click the “Create admin key” button to generate your new admin API key.
Personal admin keys access only your personal resources. Organization admin keys access their organization’s resources, including API keys, billing data, and containers. Do not share admin keys or expose them in browsers, client-side code, or public repositories. Organization admin keys are automatically revoked when the creator is removed from the organization or demoted from admin.

Step 5: Copy Your Admin Key

Your new admin key appears in the list. Hover over the key and click the copy button to copy it, or the eye button to reveal the full key. Use “Edit” to rename a key and “Delete” to revoke it.

Step 6: Test Your Key (Optional)

Send a request to the Admin API with your key as a bearer token. For example, to fetch the last 24 hours of usage:
A successful response contains your usage data. Billing routes require an unscoped key; a scoped key receives 403 Forbidden here.

Admin Key Capabilities

Personal admin keys let you manage your personal inference keys, query personal usage metrics, and access personal billing data. Organization admin keys provide the corresponding organization access, plus container management. When listing organization keys, only your own keys are returned in full — keys created by other members are masked. Admin-key creation and management require a signed-in dashboard session; an admin key cannot create more admin keys. For complete documentation of available endpoints, see the Admin API Documentation.