SandboxesGit

Unstage git changes

Unstage files. An empty files unstages the whole work tree (git restore --staged).

  • The work tree keeps the changes.
  • Local git writes on one work tree run one at a time. A write through the files endpoints does not wait for them. After a timeout, the outcome is unknown: the command can have run.
  • Runs in the sandbox as the image user. Needs write access to the sandbox, because git runs the repository's own config and filters.
  • 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.
PUT
/v1/sandboxes/{sandboxId}/git/unstage
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

sandboxId*string

Sandbox ID (ULID)

Query Parameters

resume?boolean

Wake a paused sandbox to serve this request

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

files?array<string>|

Paths relative to the work tree root, read literally (no globs); empty means the whole work tree

path?string

A directory inside the work tree: absolute, or relative to the sandbox working directory

Default"."

Response Body

application/problem+json

curl -X PUT "https://example.com/v1/sandboxes/string/git/unstage" \  -H "Content-Type: application/json" \  -d '{}'

No body.