Skip to main content

​
API Keys

The Transcord API uses API keys for authentication. Include your key in the Authorization header with every request. 
Authorization: Bearer tr_live_your_api_key

​
Getting an API Key

  1. Log in to your Transcord account
  2. Go to Settings
  3. Scroll to “API Access” and click Generate API Key
  4. Copy your key immediately - it won’t be shown again
API access requires a Pro or Business subscription.

​
API Key Format

All Transcord API keys start with tr_live_ followed by a random string: 
tr_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ12

​
Example Request

curl -X GET "https://app.transcord.app/api/v1/me" \
  -H "Authorization: Bearer tr_live_your_api_key"

​
Security Best Practices

API keys should only be used in server-side code. Never include them in JavaScript that runs in the browser, mobile apps, or any code that users can inspect.
Store your API key in environment variables, not in your source code:
.env
TRANSCORD_API_KEY=tr_live_your_api_key

const apiKey = process.env.TRANSCORD_API_KEY;
Generate a new API key periodically and update your applications. This limits the impact if a key is compromised.
If you suspect your API key has been exposed, revoke it immediately in Settings and generate a new one.

​
Rate Limits

API requests are limited to 100 requests per minute per API key. If you exceed this limit, you’ll receive a 429 Too Many Requests response: 
{
  "error": "Rate limit exceeded. Please wait before making more requests."
}

​
OAuth 2.0 (MCP Integration)

For MCP (Model Context Protocol) integrations with Claude AI, Transcord supports OAuth 2.0 with PKCE. This allows Claude to access your recordings on your behalf. See the MCP Integration guide for setup instructions.

​
Error Responses

​
401 Unauthorized

Your API key is missing, invalid, or has been revoked. 
{
  "error": "Unauthorized"
}
Solutions:
  • Check that you’re including the Authorization header
  • Verify your API key is correct (starts with tr_live_)
  • Generate a new key if yours was revoked

​
403 Forbidden

Your API key is valid but you don’t have access to the requested resource. 
{
  "error": "Forbidden"
}
Solutions:
  • Make sure you’re accessing your own recordings
  • Check that your subscription is active