Skip to main content

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 SettingsAPI 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

StatusCodeDescription
400VALIDATION_FAILEDInvalid request parameters
401UNAUTHORIZEDMissing or invalid token
4032fa_required2FA required
404NOT_FOUNDResource not found
409CONFLICTResource already exists
500INTERNAL_ERRORServer error

Postman Collection

⬇️ Download Postman Collection