Skip to content

A thread, or a reply

{body, version?, anchor?, quote?, in_reply_to?}. A thread takes anchor (Plannotator's fields, as written) or quote (plain words, stored as Plannotator's external annotation: blockId external, offsets 0); neither: the whole artifact. version defaults to the newest. A reply names in_reply_to and takes neither; it joins the thread's root. Members named with @login are recorded. Send an Idempotency-Key to make a retry safe (200 with pando-replayed). Refused: 409 too_many_threads, too_many_replies; 400 too_many_mentions; 413 too_large (body or anchor).

POST
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/artifacts/{id}/comments

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

Returns

201

Made

JSON
  • idstringrequired
  • artifactstringrequired
  • versionintegerrequired

    The version it was made on.

  • threadstringrequired

    The root's id.

  • in_reply_tostring | nullrequired
  • anchorunknownrequired

    Plannotator's placing fields and Pando's context, opaque; null: the whole artifact. Roots only.

  • bodystring | nullrequired

    Null once deleted.

  • body_versionintegerrequired
  • authorstringrequired
  • machinestring | nullrequired
  • mentionsarray ofstringrequired
  • stateopenorresolvedrequired
  • resolved_bystring | nullrequired
  • resolved_atstring | nullrequired
    format: date-time
  • created_atstringrequired
    format: date-time
  • updated_atstringrequired
    format: date-time
Navigation

Type to search…

↑↓ navigate↵ selectEsc close