Files

Get a file

Returns the file's record, including its folder id, resolved path, and stable authenticated contentUrl. Pending (prepared but not yet completed) files are visible here with status pending; deleted files respond 404.

get/api/v1/files/{fileId}

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/files/{fileId}
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

fileIdstring required

Response

The file record.

idstring required
namestring required
contentUrlstring required

Stable authenticated API URL for opening the file content. It redirects to a short-lived inline storage URL when the file is ready.

folderIdstring nullable required

The containing folder's id, or null for the root.

pathstring required

The file's full display path, including the file name. Paths change on rename/move; store ids.

kind'archive' | 'audio' | 'document' | 'image' | 'other' | 'pdf' | 'spreadsheet' | 'video' required
extensionstring nullable required
contentTypestring required
sizeBytesinteger required
status'pending' | 'ready' required
createdAtstring required
updatedAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.