Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/21st-dev/1code/llms.txt

Use this file to discover all available pages before exploring further.

​
API Keys

The 1Code API uses API keys for authentication. Include your API key in the Authorization header of each request. 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://1code.dev/api/v1/tasks

​
Getting Your API Key

  1. Sign in to your 1Code account
  2. Navigate to Settings > API Keys
  3. Click “Create API Key”
  4. Copy and securely store your API key
API keys grant full access to your account. Never share your API keys or commit them to version control.

​
API Key Format

API keys follow the format: 
1code_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Keys starting with 1code_live_ are production keys
  • Keys starting with 1code_test_ are test keys (sandbox mode)

​
Authentication Errors

​
Missing API Key

HTTP 401 Unauthorized 
{
  "error": "missing_authorization",
  "message": "Authorization header is required"
}

​
Invalid API Key

HTTP 401 Unauthorized 
{
  "error": "invalid_api_key",
  "message": "The API key provided is invalid or has been revoked"
}

​
Expired API Key

HTTP 401 Unauthorized 
{
  "error": "expired_api_key",
  "message": "The API key has expired. Please generate a new one."
}

​
Best Practices

Use environment variables or a secrets manager to store API keys. Never hardcode them in your source code.
export ONECODE_API_KEY="1code_live_..."
Generate new API keys periodically and revoke old ones to minimize security risks.
Use test keys during development to avoid affecting production data. Test keys run in sandbox mode.
Track your API usage in the dashboard to detect unauthorized access or unusual patterns.

​
Managing API Keys

​
List API Keys

View all your API keys in the dashboard at Settings > API Keys.

​
Revoke API Keys

Revoke an API key immediately if it’s compromised:
  1. Go to Settings > API Keys
  2. Click the revoke button next to the key
  3. Confirm revocation
Revoked keys cannot be restored. You’ll need to generate a new key.

​
Next Steps

Create your first task

Start using the API to run agent tasks

Build docs developers (and LLMs) love

Get started for freeTalk to us