Skip to content
Pando

The combined status of a commit (latest per context)

GET
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/repos/{repo}/commits/{ref}/status
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).

  • refstringrequired

    A sha or a branch name (%2F for slashes).

Returns

200

OK

JSON
  • 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