Skip to main content

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

ParameterTypeRequiredDescription
envIdstring (UUID)YesEnvironment 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 CodeDescription
401Unauthorized - Invalid or missing authentication
403Forbidden - User doesn't have access to the environment
404Not Found - Environment doesn't exist
500Internal Server Error

Examples

curl -X GET "https://api.thevenin.cloud/api/v1/{envId}/file" \
-H "Authorization: Bearer tvn_your_api_token_here"