Skip to content
Pando

Upload an artifact, or the next version of one with the same name

Multipart, with Content-Length (411 without it): one file field (a .md, .markdown, .html, .htm, .png, .jpg, .jpeg, .gif, .webp or .svg file; its name is the artifact's) and an image field for each image a document uses, the file's name its path from the document (img/hero.png). Refused: 413 too_large (over 10 MiB in all, or a document over 1.5 MiB), 400 too_many_files (over 20), 409 too_many_artifacts (100 on the branch), 400 bad_request (a name, path or kind Pando does not take). Each file's SHA-256 is computed and checked by R2.

POST
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/repos/{repo}/branches/{branch}/artifacts
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).

  • branchstringrequired

    The branch's name; a '/' in it raw or as %2F.

Request bodyFORM-DATArequired

  • filestringrequired
    format: binary
  • imageoptionalarray ofstring
    format: binary

Returns

201

A new artifact (200 when it is the next version of one)

JSON
  • idstringrequired
  • repostringrequired
  • branchstringrequired
  • namestringrequired
  • kindmarkdownorhtmlorimagerequired
  • titlestring | nullrequired

    The first heading or , at most 200 characters.</p>

  • latestobjectrequired
    8 properties
    • nintegerrequired
    • sizeintegerrequired

      All its files

    • sha256stringrequired

      The main file's.

    • filesarray ofobjectrequired

      The main file first, then its images by path.

      4 properties
      • pathstringrequired
      • sizeintegerrequired
      • sha256stringrequired
      • typestringrequired
    • uploaded_bystringrequired
    • machinestring | nullrequired

      The credential's machine; web from the browser.

    • viaweborclirequired
    • created_atstringrequired
      format: date-time
  • versionsintegerrequired
  • commentsobjectrequired
    2 properties
    • openintegerrequired
    • resolvedintegerrequired
  • created_bystringrequired
  • created_atstringrequired
    format: date-time
  • updated_atstringrequired
    format: date-time
Navigation

Type to search…

↑↓ navigate↵ selectEsc close