Templates

Get one entry of a template version’s file tree

404 path_not_found; 409 file_list_unavailable / file_list_indexing; 422 invalid_path.

get/v1/templates/{slug}/versions/{version}/files/entry

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/templates/{slug}/versions/{version}/files/entry
  • Auth: HTTP bearer

Path parameters

slugstring required
versioninteger required

Query parameters

pathstring required

Absolute path (/, /home/user, no trailing slash).

owner'platform' | 'organization'

Pick the platform template even when an organization template shadows its slug.

Response

One inode path of a template version. A path that is not valid UTF-8 shows each invalid byte as \xNN.

pathstring required
namestring required

The last path component (`` for /).

type'file' | 'dir' | 'symlink' | 'char' | 'block' | 'fifo' required
size_bytesinteger required
modeinteger required

Permission bits (low 12: rwx, setuid, setgid, sticky).

uidinteger required
gidinteger required
sha256string nullable required

Content SHA-256 (regular files).

link_targetstring nullable required
hardlink_ofstring nullable required

The first path of this entry’s hardlink group.

child_countinteger nullable required

Directories: entries directly inside.

Changes

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