Skip to content

The Machines tab, one row per machine (a credential), latest activity first

A machine is a credential: the row's key is (login, credential_id), and it is shown by the credential's name, so two people's laptops stay apart. Kept by the monorepo in the same step as each change:

  • every activity event made through the credential sets last_activity (the line's kind, repo, branch and summary, as in FeedEvent; a push's commit count and title arrive a moment later);
  • a follower's hello on the event socket sets it connected, with its worktrees; its last such socket closing sets it disconnected. Machines with no activity yet (only connected) come after the others. Browser sessions (kind browser) appear only once they act, never as connected; show them as the web. Live: machine.updated on the event stream.
GET
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/machines

Authorisation

  • credentialoptionalHTTP
  • sessionoptionalAPI key in cookie

Path parameters

  • ownerstringrequired

    The monorepo's owner, a namespace (a person's login or an organization). Matched without case.

    pattern: ^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$
  • monorepostringrequired

    The monorepo's name within its owner (or an old name). Matched without case.

    pattern: ^[a-z0-9](?:[a-z0-9._]|-(?!-)){0,38}$

Returns

200

OK

JSON
  • machinesarray ofobjectrequired
    9 properties
    • loginstringrequired

      The person.

    • credential_idstringrequired

      With login, the machine's key.

    • namestringrequired

      The credential's name: the machine as people see it.

    • kindmachineorsandboxorbootstraporbrowserornullrequired
    • connectedbooleanrequired

      An event socket of this credential said hello and is open.

    • connected_atstring | nullrequired
      format: date-time
    • last_activityobject | nullrequired

      Its latest activity line in this monorepo.

      7 properties
      • seqoptionalinteger
      • atoptionalstring
        format: date-time
      • kindoptionalstring
      • repooptionalstring | null
      • repo_pathoptionalstring | null
      • branchoptionalstring | null
      • summaryoptionalobject | null

        As FeedEvent.summary.

    • worktreesarray ofobjectrequired

      The worktrees its last hello named; repo, branch and path from the worktree registry (null when not reported there).

      4 properties
      • idoptionalstring
      • repooptionalstring | null
      • branchoptionalstring | null
      • pathoptionalstring | null
    • updated_atstringrequired
      format: date-time
Navigation

Type to search…

↑↓ navigate↵ selectEsc close