API Reference
The Thevenin API allows you to programmatically manage your infrastructure, applications, and resources.
Base URL
https://api.thevenin.com/api/v1
Authentication
All requests require a Bearer token in the Authorization header:
Authorization: Bearer tvn_your_token_here
Creating a token: Navigate to Settings → API Tokens in your dashboard. 2FA must be enabled.
warning
Tokens are shown only once. Store them securely and never commit to version control.
Response Format
All responses are JSON.
Success:
{
"id": "app-123",
"name": "my-application",
"status": "active"
}
Error:
{
"code": "VALIDATION_FAILED",
"message": "Invalid request body",
"details": "Application name is required"
}
Error Codes
| Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_FAILED | Invalid request parameters |
| 401 | UNAUTHORIZED | Missing or invalid token |
| 403 | 2fa_required | 2FA required |
| 404 | NOT_FOUND | Resource not found |
| 409 | CONFLICT | Resource already exists |
| 500 | INTERNAL_ERROR | Server error |