Skip to content
Pando

One commit, the branch it came from, and its checks (the web's commit page)

branch is the branch it was pushed on, when Pando knows it: the earliest branch that listed it among its own commits (the newest 250 of each branch are recorded when Pando compares the branch with main), else a branch whose head it is or was, else the branch a session saw it on. merge_of is set when the commit is Pando's merge of a branch into the default branch. author_person is the person whose sign-in email (or <login>@users.pando.invalid) is the author's, when they can open the monorepo.

GET
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/repos/{repo}/commits/{sha}
View as Markdown

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}$
  • repostringrequired

    The repo's name (projects-web).

  • shastringrequired

    A full sha, or its first 7 to 39 characters. A short one is looked up among the commits Pando has recorded in the repo (branch heads, branches' own commits, merges, checks, sessions' commits), then in main's newest 1,000 first-parent commits (one Artifacts read); a 404 when none or more than one starts so.

Returns

200

OK

JSON
  • commitobjectrequired
    8 properties
    • shastringrequired
    • parentsarray ofstringrequired
    • titlestringrequired

      The message's first line.

    • messagestringrequired

      The full message, at most 4,096 characters.

    • authorobjectrequired
      3 properties
      • nameoptionalstring | null
      • emailoptionalstring | null
      • dateoptionalstring | null
        format: date-time
    • committerobjectrequired
      3 properties
      • nameoptionalstring | null
      • emailoptionalstring | null
      • dateoptionalstring | null
        format: date-time
    • trailersobjectrequired
      3 properties
      • agentstring | nullrequired
      • worktreestring | nullrequired
      • machinestring | nullrequired
    • co_authorsoptionalarray ofobject

      Co-authored-by: Name <email> lines from the message's trailers (its last paragraph), each once, as git and GitHub read them.

      2 properties
      • namestringrequired
      • emailstring | nullrequired
  • author_personobject | nullrequired
    2 properties
    • loginoptionalstring
    • picture_urloptionalstring | null
  • branchCommitBranchornullrequired
    2 variants

    One of the following:

    • CommitBranch
      View CommitBranch schema →
      4 properties
      • namestringrequired
      • titlestring | nullrequired
      • stateopenormergedordeletedrequired
      • merge_commitstring | nullrequired

        Its merge into the default branch

    • null
  • merge_ofCommitBranchornullrequired
    2 variants

    One of the following:

    • CommitBranch
      View CommitBranch schema →
      4 properties
      • namestringrequired
      • titlestring | nullrequired
      • stateopenormergedordeletedrequired
      • merge_commitstring | nullrequired

        Its merge into the default branch

    • null
  • checksobjectrequired

    GitHub's combined status, plus the required contexts and which are missing.

    6 properties
    • shastring | nullrequired
    • statesuccessorpendingorfailureorerrorormissingorunknownrequired

      success when the merge gate passes; missing when a required context has not reported; unknown while the required checks are (an unforced merge is refused).

    • requiredarray | nullrequired

      Null while unknown.

    • checks_unknownstring | nullrequired

      Why the required checks are unknown, in plain words: "Pando couldn't read this monorepo's required checks; try again", or "pando.toml line 3: expected comma or end of structure; fix it on main, or merge with force". Null otherwise.

    • statusesarray ofobjectrequired

      The latest status per context.

      8 properties
      • shastringrequired
      • contextstringrequired
      • statependingorsuccessorfailureorerrorrequired
      • created_atstringrequired
        format: date-time
      • target_urloptionalstring | null
      • descriptionoptionalstring | null
      • creatoroptionalstring

        The member who posted it (a login); app:<slug> for a status posted with a status token or by a CI integration; hook:<hook id> for a status token from a web hook with no app.

      • appoptionalstring | null

        The CI service that reported it (buildkite, github-actions, ...), stamped by Pando from a status token or a CI integration, never from the body or target_url. Null when a member posted it with their own credential. The web shows the service's mark for a slug it knows.

    • missingoptionalarray ofstring

404

An error

JSON
  • errorobjectrequired
    4 properties
    • codestringrequired
    • messagestringrequired
    • pathsoptionalarray ofstring
    • checksoptionalobject

      GitHub's combined status, plus the required contexts and which are missing.

      6 properties
      • shastring | nullrequired
      • statesuccessorpendingorfailureorerrorormissingorunknownrequired

        success when the merge gate passes; missing when a required context has not reported; unknown while the required checks are (an unforced merge is refused).

      • requiredarray | nullrequired

        Null while unknown.

      • checks_unknownstring | nullrequired

        Why the required checks are unknown, in plain words: "Pando couldn't read this monorepo's required checks; try again", or "pando.toml line 3: expected comma or end of structure; fix it on main, or merge with force". Null otherwise.

      • statusesarray ofobjectrequired

        The latest status per context.

        8 properties
        • shastringrequired
        • contextstringrequired
        • statependingorsuccessorfailureorerrorrequired
        • created_atstringrequired
          format: date-time
        • target_urloptionalstring | null
        • descriptionoptionalstring | null
        • creatoroptionalstring

          The member who posted it (a login); app:<slug> for a status posted with a status token or by a CI integration; hook:<hook id> for a status token from a web hook with no app.

        • appoptionalstring | null

          The CI service that reported it (buildkite, github-actions, ...), stamped by Pando from a status token or a CI integration, never from the body or target_url. Null when a member posted it with their own credential. The web shows the service's mark for a slug it knows.

      • missingoptionalarray ofstring
Navigation

Type to search…

↑↓ navigate↵ selectEsc close