Set a file owner
Set the owner, the group, or both of path, like chown.
ownerandgrouptake a name from/etc/passwdor/etc/groupof the sandbox, or a number.- An empty
ownerorgroupkeeps it. Both empty, or an unknown name, returns 422invalid_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
userwhen set. Settinguserneeds write access to the sandbox. - Served at the access endpoint of the sandbox (
access_endpointofGET /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 409sandbox_update_requireduntil 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.~namereturns 422.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Sandbox ID (ULID)
Query Parameters
Wake a paused sandbox to serve this request
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
New group, by group name or gid; empty keeps the group
^[a-z_][a-z0-9_-]{0,31}$|^[0-9]{1,10}$New owner, by user name or uid; empty keeps the owner
^[a-z_][a-z0-9_-]{0,31}$|^[0-9]{1,10}$File or directory; a final symlink is followed
1 <= lengthGuest user to run as, by name or uid; defaults to the image user. Only root can change the owner
^[a-z_][a-z0-9_-]{0,31}$|^[0-9]{1,10}$Response Body
application/json
application/problem+json
curl -X PUT "https://example.com/v1/sandboxes/string/files/owner" \ -H "Content-Type: application/json" \ -d '{ "path": "string" }'{ "entry": { "gid": 0, "group": "string", "mode": 0, "modified_at": "2019-08-24T14:15:22Z", "name": "string", "owner": "string", "path": "string", "size": 0, "symlink_target": "string", "type": "file", "uid": 0 }}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}Set a file mode PUT
Set the permission bits of `path`, like `chmod`. - A final symlink is followed. The change is not recursive. - Only the owner or root can change a mode. Another user 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 file content HEAD
Return the file size and an ETag for files up to 1 GiB.