Skip to main content
GET
/
v2
/
files
/
{fileId}
Get File
curl --request GET \
  --url https://api.tusky.io/v2/files/{fileId}
{
  "id": "<string>",
  "name": "<string>",
  "mimeType": "<string>",
  "size": 123,
  "blobId": "<string>",
  "quiltPatchId": "<string>",
  "environmentId": "<string>",
  "createdAt": "<string>",
  "expiresAt": "<string>"
}
Retrieve metadata for a specific file.

​
Path Parameters

​
fileId
string
required
The unique identifier of the file.

​
Response

​
id
string
Unique identifier for the file.
​
name
string
Original filename.
​
mimeType
string
MIME type of the file.
​
size
number
File size in bytes.
​
blobId
string
Walrus blob identifier for the stored file.
​
quiltPatchId
string
Quilt patch identifier for the file metadata on Sui.
​
environmentId
string
The environment this file belongs to.
​
createdAt
string
ISO 8601 timestamp of when the file was uploaded.
​
expiresAt
string
ISO 8601 timestamp of when the file’s storage expires.

​
Example

curl https://api.tusky.io/v2/files/file_mno345pqr678 \
  -H "Api-Key: YOUR_API_KEY"

​
Response

{
  "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"
}