Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sawmills.ai/llms.txt

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

​
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..."

​
Authentication Headers

PurposeHeader FormatExample
Create/Manage API KeysAuthorization: Bearer {jwt}Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Exchange for TokenAuthorization: ApiKey {key}Authorization: ApiKey sk_test.abc123def4.xyz789uvw0123456789abcdef
Make API CallsAuthorization: Bearer {token}Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

​
Common Error Codes

CodeMeaningSolution
UNAUTHENTICATEDInvalid credentialsCheck API key/token validity
PERMISSION_DENIEDInsufficient permissionsVerify scopes
NOT_FOUNDResource not foundCheck if key exists
INVALID_ARGUMENTBad requestValidate 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

  • API key is correctly formatted
  • API key is active and not revoked
  • Authorization header uses correct scheme (ApiKey vs Bearer)
  • Token hasn’t expired (30 minutes default)
  • HTTPS is being used
  • No extra whitespace in credentials
  • Correct environment (test vs live)