List Files
Retrieve all configuration files in a specific environment.
Endpoint
GET /{envId}/file
Authentication
Required: Yes (Session or Bearer Token with 2FA)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
envId | string (UUID) | Yes | Environment ID |
Response
Success Response (200 OK)
Returns an array of file objects.
[
{
"id": "file-550e8400-e29b-41d4-a716-446655440000",
"name": "app-config.json",
"envIdRef": "660e8400-e29b-41d4-a716-446655440001",
"companyIdRef": "770e8400-e29b-41d4-a716-446655440002",
"content": "{\"port\": 8080, \"debug\": true}",
"mountPath": "/app/config",
"isDeleted": false,
"createdBy": "user-123",
"version": 1
},
{
"id": "file-660e8400-e29b-41d4-a716-446655440001",
"name": "nginx.conf",
"envIdRef": "660e8400-e29b-41d4-a716-446655440001",
"companyIdRef": "770e8400-e29b-41d4-a716-446655440002",
"content": "server { listen 80; ... }",
"mountPath": "/etc/nginx/nginx.conf",
"isDeleted": false,
"createdBy": "user-123",
"version": 1
}
]
Error Responses
| Status Code | Description |
|---|---|
| 401 | Unauthorized - Invalid or missing authentication |
| 403 | Forbidden - User doesn't have access to the environment |
| 404 | Not Found - Environment doesn't exist |
| 500 | Internal Server Error |
Examples
curl -X GET "https://api.thevenin.cloud/api/v1/{envId}/file" \
-H "Authorization: Bearer tvn_your_api_token_here"