Check file content
Return the file size and an ETag for files up to 1 GiB.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Query Parameters
Absolute, or relative to the sandbox working directory. A path that starts with ~ or ~/ names the home directory of the user that the operation runs as. ~name returns 422.
Response Body
curl -X HEAD "https://example.com/v1/sandboxes/string/files/content?path=string"No body.
No body.
No body.
No body.
No body.
No body.
No body.
No body.
No body.
Set a file owner PUT
Set the owner, the group, or both of `path`, like `chown`. - `owner` and `group` take a name from `/etc/passwd` or `/etc/group` of the sandbox, or a number. - An empty `owner` or `group` keeps it. Both empty, or an unknown name, returns 422 `invalid_argument`. - A final symlink is followed. The change is not recursive. - Only root can change the owner. The owner can change the group only to one of its own groups. Anything else gets 403 `permission_denied`. - Needs write access to the sandbox. - Runs in the sandbox as the image user, or as `user` when set. Setting `user` needs write access to the sandbox. - Served at the access endpoint of the sandbox (`access_endpoint` of `GET /v1/sandboxes/{sandboxId}`), not at the API host. - A paused sandbox returns 409, unless `resume=true`. A sandbox that started before its files server existed returns 409 `sandbox_update_required` until it restarts. - A refused operation returns its code as the problem type. - A path that starts with `~` or `~/` names the home directory of the user that the operation runs as. `~name` returns 422.
Check a file through a signed URL HEAD
Return the size and `ETag` of the file of a GET signed URL, like `HEAD files/content`. - An archive URL returns 405. - Needs no other credential. - Served at the access endpoint. The mint returns the full URL. See [Share a file with a signed URL](https://docs.tektona.ai/files#share-a-file-with-a-signed-url) in the guide.