Overview
AudioPod AI supports two authentication methods:
- API Key: Use
X-API-Key header (recommended for servers)
- JWT Token: Use
Authorization: Bearer {token} header (for sessions)
Registration
Step 1: Initiate Registration
curl -X POST "https://api.audiopod.ai/api/v1/auth/initiate-registration" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "SecurePass123",
"full_name": "Developer Name"
}'
{
"message": "Verification code sent to your email. Please check your inbox."
}
Step 2: Verify Email
curl -X POST "https://api.audiopod.ai/api/v1/auth/verify-registration" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"verification_code": "123456"
}'
{
"user": {
"id": "uuid",
"email": "[email protected]",
"full_name": "Developer Name",
"is_verified": true
},
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"refresh_token": "eyJhbGciOiJIUzI1NiIs...",
"token_type": "bearer",
"expires_in": 3600
}
Login
curl -X POST "https://api.audiopod.ai/api/v1/auth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "[email protected]&password=SecurePass123"
API Keys
Create API Key
Use JWT token from login/registration:
curl -X POST "https://api.audiopod.ai/api/v1/auth/api-keys" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "production-key",
"scopes": ["*"],
"expires_in_days": null
}'
{
"id": "key-uuid",
"name": "production-key",
"api_key": "ap_xxxxxxxxxxxxxxxx",
"scopes": ["*"],
"created_at": "2025-01-01T00:00:00Z",
"expires_at": null
}
The api_key is only shown once. Save it immediately!
List API Keys
curl -X GET "https://api.audiopod.ai/api/v1/auth/api-keys" \
-H "X-API-Key: $AUDIOPOD_API_KEY"
Revoke API Key
curl -X DELETE "https://api.audiopod.ai/api/v1/auth/api-keys/{key_id}" \
-H "X-API-Key: $AUDIOPOD_API_KEY"
Password Reset
Request Reset
curl -X POST "https://api.audiopod.ai/api/v1/auth/forgot-password" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'
Confirm Reset
curl -X POST "https://api.audiopod.ai/api/v1/auth/reset-password" \
-H "Content-Type: application/json" \
-d '{
"token": "reset_token_from_email",
"new_password": "NewSecurePass123"
}'
Token Refresh
curl -X POST "https://api.audiopod.ai/api/v1/auth/refresh" \
-H "Content-Type: application/json" \
-d '{"refresh_token": "eyJhbGciOiJIUzI1NiIs..."}'
Get Current User
curl -X GET "https://api.audiopod.ai/api/v1/auth/me" \
-H "X-API-Key: $AUDIOPOD_API_KEY"
{
"id": "uuid",
"email": "[email protected]",
"full_name": "Developer Name",
"is_verified": true,
"created_at": "2025-01-01T00:00:00Z"
}
Errors
| Code | Error | Description |
|---|
401 | invalid_credentials | Wrong email or password |
401 | token_expired | Access token expired |
400 | email_already_registered | Email already in use |
400 | invalid_verification_code | Wrong or expired code |
429 | rate_limit_exceeded | Too many requests |
Quick Reference
| Endpoint | Method | Auth | Description |
|---|
/auth/initiate-registration | POST | None | Start registration |
/auth/verify-registration | POST | None | Verify email |
/auth/token | POST | None | Login |
/auth/refresh | POST | None | Refresh token |
/auth/forgot-password | POST | None | Request reset |
/auth/reset-password | POST | None | Confirm reset |
/auth/me | GET | Required | Get user info |
/auth/api-keys | GET | Required | List API keys |
/auth/api-keys | POST | Required | Create API key |
/auth/api-keys/{id} | DELETE | Required | Revoke API key |
