API Key Commands
Create API Key
curl -X POST "https://api.sawmills.ai/v1/user-api-keys" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"label": "My Key"}'
JWT Token: Get YOUR_JWT_TOKEN from Chrome DevTools → Network tab → Find API request → Copy Authorization header value (after “Bearer ”).
List API Keys
curl -X GET "https://api.sawmills.ai/v1/user-api-keys" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Revoke API Key
curl -X DELETE "https://api.sawmills.ai/v1/user-api-keys/{key_id}" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Token Commands
Exchange API Key for Token
curl -X POST "https://api.sawmills.ai/v1/token" \
-H "Authorization: ApiKey sk_test.abc123def4.xyz789uvw0123456789abcdef" \
-H "Content-Type: application/json" \
-d '{}'
Use Token for API Call
curl -X GET "https://api.sawmills.ai/v1/user-api-keys" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
| Purpose | Header Format | Example |
|---|
| Create/Manage API Keys | Authorization: Bearer {jwt} | Authorization: Bearer eyJhbGciOiJSUzI1NiIs... |
| Exchange for Token | Authorization: ApiKey {key} | Authorization: ApiKey sk_test.abc123def4.xyz789uvw0123456789abcdef |
| Make API Calls | Authorization: Bearer {token} | Authorization: Bearer eyJhbGciOiJSUzI1NiIs... |
Common Error Codes
| Code | Meaning | Solution |
|---|
UNAUTHENTICATED | Invalid credentials | Check API key/token validity |
PERMISSION_DENIED | Insufficient permissions | Verify scopes |
NOT_FOUND | Resource not found | Check if key exists |
INVALID_ARGUMENT | Bad request | Validate parameters |
Environment Variables
## Required
export SAWMILLS_API_KEY="sk_test.abc123def4.xyz789uvw0123456789abcdef"
export SAWMILLS_BASE_URL="https://api.sawmills.ai"
# Optional
export SAWMILLS_TIMEOUT="30"
export SAWMILLS_RETRY_ATTEMPTS="3"
Testing Authentication
Test API Key
# Test with your API key
curl -X POST "https://api.sawmills.ai/v1/token" \
-H "Authorization: ApiKey YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' \
-w "HTTP Status: %{http_code}\n"
# Expected: HTTP Status: 200
Test Token Exchange
# Test with valid API key
curl -X POST "https://api.sawmills.ai/v1/token" \
-H "Authorization: ApiKey $SAWMILLS_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' \
-w "HTTP Status: %{http_code}\n"
# Expected: HTTP Status: 200
Test API Call
# Test with access token
curl -X GET "https://api.sawmills.ai/v1/user-api-keys" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-w "HTTP Status: %{http_code}\n"
# Expected: HTTP Status: 200
Troubleshooting Checklist
