sessions module route (requires sessions:run:read)

GET

/v1/m/sessions/runs/{ref}/git

curl --request GET \
  --url https://example.com/v1/m/sessions/runs/example/git \
  --header 'Authorization: Bearer <token>'

• this engine

Returns the current branch, local branches, working-tree status and write policy in the session’s folder.

Authorizations

• bearerAuth
• browserSession

Parameters

Path Parameters

ref

required

string

Path parameter ref.

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Responses

200

Confined local Git status and folder write policy

Media type application/json

object

branch

required

Current local branch; empty for detached HEAD.

string

branches

required

Array<string>

<= 200 items

files

required

Array<object>

<= 200 items

object

index

required

string

path

required

string

worktree

required

string

truncated

required

boolean

writable

required

boolean

Example ^generated

{
  "branch": "example",
  "branches": [
    "example"
  ],
  "files": [
    {
      "index": "example",
      "path": "example",
      "worktree": "example"
    }
  ],
  "truncated": true,
  "writable": true
}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Git refused the operation, the workspace changed, or the work lease is stale

Media type application/json

object

Example ^generated

{}

422

Unsupported isolation or Git output limit exceeded

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}

502

Session OS boundary could not be established; no unconfined fallback

Media type application/json

object

Example ^generated

{}

503

Session confinement, Git, policy or store is unavailable

Media type application/json

object

Example ^generated

{}