SandboxesGit

Get git log

List the commits of ref, newest first. Page with limit and skip.

  • 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.
GET
/v1/sandboxes/{sandboxId}/git/log
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

path?string

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

Default"."
resume?boolean

Wake a paused sandbox to serve this request

ref?string

Revision to list the history of

Match^[^-\x00\n\r][^\x00\n\r]*$
Default"HEAD"
limit?integer

Maximum number of commits

Formatint32
Range1 <= value <= 500
Default50
skip?integer

Commits to skip, for paging

Formatint32
Range0 <= value

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/v1/sandboxes/string/git/log"
{  "commits": [    {      "author_email": "string",      "author_name": "string",      "authored_at": "2019-08-24T14:15:22Z",      "committed_at": "2019-08-24T14:15:22Z",      "committer_name": "string",      "oid": "string",      "parents": [        "string"      ],      "subject": "string"    }  ]}

Get git diff files GET

Compare the working tree (staged and unstaged changes) with `base`, file by file, and list untracked files. - The `lines` object counts changed lines, or is null when the count is unknown. - To get the base side of a file, call `GET git/blob` with `old_oid`. - 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.

Get a git patch GET

Return the staged, unstaged and untracked, not ignored changes against `base` as one unified patch. - Run `git apply -p1` in the work tree root to apply it. Binary files are included. - A patch above 6 MiB stops after its last complete file and sets `Tektona-Git-Truncated: true`. - The index of the repository does not change. - 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.