Skip to content

A new chat with the repository assistant

One session (kind chat) per conversation, per person. It answers from Pando's read tools with the caller's access and no sandbox; asked for a change, it starts its own branch assistant/<n> and works as a task does. A chat is its person's alone: not in GET .../agents, and 404 to anyone else. Follow-ups, the transcript, the socket and Stop are the agents routes'.

POST
https://app.gitpando.com/v1/monorepos/{owner}/{monorepo}/assistant

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

Request bodyJSONrequired

  • promptstringrequired
    maxLength: 65536
  • repooptionalstring
  • modeloptionalstring

Returns

201

Started

JSON
  • numberintegerrequired
  • kindtaskorissueorrevieworchatrequired
  • statusworkingorwaitingorfailedorstoppedrequired
  • reasonstring | nullrequired
  • repostringrequired
  • branchstring | nullrequired

    Named by a person or from its issue; null for an assistant's chat until the person names one.

  • programstringrequired

    pi

  • modelstringrequired
  • issueinteger | nullrequired
  • launched_bystringrequired
  • machinestringrequired

    The session's credential, cloud-.

  • workspacemountorcloneornullrequired
  • awaiting_checksbooleanrequired

    Its merge waits for required checks still running; Pando tells it when they are green.

  • first_messagestring | nullrequired

    An assistant's chat: its first message, cut at 200 characters; null for other kinds.

  • created_atstringrequired
    format: date-time
  • updated_atstringrequired
    format: date-time
  • branch_factsoptionalobject | null

    In a list only. Its branch now (state, ahead, merged_at, checks); null while the branch is not made yet.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close