Skip to main content
GET
/
v2
/
environments
/
{environmentId}
/
files
List Files
curl --request GET \
  --url https://api.tusky.io/v2/environments/{environmentId}/files
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "mimeType": "<string>",
      "size": 123,
      "blobId": "<string>",
      "quiltPatchId": "<string>",
      "environmentId": "<string>",
      "createdAt": "<string>",
      "expiresAt": "<string>"
    }
  ],
  "nextCursor": "<string>",
  "hasMore": true
}
List all files within a specific environment. Results are returned in reverse chronological order and paginated using cursor-based pagination.

​
Path Parameters

​
environmentId
string
required
The unique identifier of the environment.

​
Query Parameters

​
cursor
string
Opaque cursor from a previous response to fetch the next page of results.
​
limit
number
default:"20"
Number of files to return per page. Minimum 1, maximum 100.
​
mimeType
string
Filter files by MIME type. For example, image/png or application/pdf.

​
Response

​
data
array
Array of file objects.
​
nextCursor
string
Cursor to pass as a query parameter to retrieve the next page. null if there are no more results.
​
hasMore
boolean
Whether there are more results beyond this page.

​
Example

curl "https://api.tusky.io/v2/environments/env_abc123def456/files?limit=10&mimeType=application/pdf" \
  -H "Api-Key: YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "id": "file_mno345pqr678",
      "name": "document.pdf",
      "mimeType": "application/pdf",
      "size": 1048576,
      "blobId": "walrus_blob_abc123",
      "quiltPatchId": "qp_def456",
      "environmentId": "env_abc123def456",
      "createdAt": "2025-07-01T12:30:00.000Z",
      "expiresAt": "2025-07-11T12:30:00.000Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}