Files and assets endpoints
List safe project files, read content and retrieve time-limited asset URLs.
GET /projects/{projectId}/files
| Parameter | Behaviour |
|---|---|
q | Case-insensitive search in file path. |
language | Exact language filter, maximum 40 characters. |
sort | path, filename, created_at, updated_at, version |
| Pagination | Defaults to 50 files, maximum 100. |
The list returns metadata only: id, path, filename, file type, language, version, generation flags and timestamps. Sensitive paths are removed from the result.
GET /projects/{projectId}/files/content
Provide one exact project-relative path in the required path query parameter. Folder records are not returned. The UTF-8 content limit is 1,000,000 bytes.
curl --get "https://aetherionai.org/api/v1/projects/PROJECT_ID/files/content" \
--data-urlencode "path=app/page.tsx" \
-H "Authorization: Bearer YOUR_API_KEY"Sensitive paths are blocked
Environment files, credential files, private-key formats and secret-like filenames return a 403 response even when a matching project record exists.
GET /projects/{projectId}/assets
| Parameter | Behaviour |
|---|---|
type | Exact asset_type filter. |
q | Case-insensitive search in file_name. |
sort | created_at, updated_at, file_name, asset_type |
| Pagination | Shared list parameters. |
Each asset can include a signed download_url valid for 3,600 seconds. Treat the URL as temporary and request a new list when it expires.
Need project-specific help?
Open the private Help Center or create a support ticket with the affected project, route and request ID.