Skip to content

The branch's own commits, newest first, with Pando's trailers parsed

The commits on the branch that are not on the default branch (the ones ahead counts), in git log's order: each commit before its parents. trailers holds the who-made-it lines (Pando-Agent, Pando-Worktree, Pando-Machine), read from the message's last paragraph.

GET
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/repos/{repo}/branches/{branch}/commits

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).

  • branchstringrequired

    The branch name, / encoded as %2F.

Query parameters

  • limitoptionalinteger

    At most 250.

    maximum: 250, minimum: 1
    Default: 250

Returns

200

OK

JSON
  • branchstringrequired
  • headstringrequired
  • base_branchstringrequired
  • merge_basestring | nullrequired
  • totalintegerrequired

    Commits on the branch only; may be more than returned.

  • truncatedbooleanrequired
  • commitsarray ofobjectrequired
    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

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