Fetch File

Retrieve file metadata and proxy URLs by file ID

GET /:projectId/api/v7/storage/:fileId

Fetch File

cURL

curl --request GET \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/storage/:fileId

200

{
  "fileId": "<string>",
  "type": "<string>",
  "originalPath": "<string>",
  "originalSize": 123,
  "originalMimeType": "<string>",
  "position": 123,
  "metadata": {},
  "userId": "<string>",
  "entityId": "<string>",
  "commentId": "<string>",
  "spaceId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "image": {
    "originalWidth": 123,
    "originalHeight": 123,
    "variants": {},
    "processingStatus": "<string>",
    "format": "<string>",
    "quality": 123,
    "exifStripped": true
  }
}

Returns metadata and proxy URLs for a file. For image files, also returns the image extension data including all variants.

Requires an authenticated user.

Rate limit: 100 requests per 5 minutes.

Path Parameters

fileId · string · required

The UUID of the file to retrieve.

Response

Base fields (all file types)

fileId · string

The file’s UUID.

type · string

One of: image, video, document, other.

originalPath · string

Proxy URL for the original file.

originalSize · number

File size in bytes at the time of upload.

originalMimeType · string

MIME type of the uploaded file.

position · number

Display order in a multi-attachment context.

metadata · object

Custom metadata stored at upload time. Always includes originalName and uploadedAt.

userId · string

ID of the user who uploaded the file (present if associated).

entityId · string

ID of the associated entity (present if provided at upload).

commentId · string

ID of the associated comment (present if provided at upload).

spaceId · string

ID of the associated space (present if provided at upload).

createdAt · string

ISO 8601 timestamp.

updatedAt · string

ISO 8601 timestamp.

Image extension (only when type === "image")

image · object

Image processing details.

Show image fields

originalWidth · number

Pixel width of the source image before processing.

originalHeight · number

Pixel height of the source image before processing.

variants · object

Named variants. Each key maps to { publicPath, width, height, size, format }.

processingStatus · string

"completed" or "failed".

format · string

Output format (e.g., "webp").

quality · number

Quality setting used during processing.

exifStripped · boolean

Whether EXIF metadata was removed.

Error Responses

Not Found — 404

{ "error": "File not found", "code": "storage/file-not-found" }