Zum Inhalt springen
DE EN

Tickets

Tickets auflisten: list_tickets

Liefert die Tickets eines Projekts, die neuesten zuerst, mit ID und Nummer.

Argument Bedeutung
status Status-Wert des Projekts
assignee Benutzer-ID oder me für dich
tag Name eines Tags
q Volltextsuche in Titel und Text
page, per_page Seite, höchstens 100 je Seite
Status gehört zum Projekt

Jedes Projekt legt seine Status selbst fest. Ein geratener Wert wie open liefert in einem Projekt, das offen sagt, einfach null Treffer. Die gültigen Werte stehen in meta.available_statuses eines Aufrufs ohne Filter. Was ein Status bedeutet, sagt status_functions, etwa is_open oder is_completed.

Ein Ticket lesen: get_ticket

Der Agent nennt entweder ticket_id oder number, also die Nummer aus der App wie 187 oder #187. Eine Nummer gilt nur innerhalb eines Projekts. Stehen beide da, zählt die ID.

Die Antwort enthält die Kopfdaten, die Beschreibung, eigene Felder, Kommentare und Anhänge.

Argument Bedeutung
posts_page, posts_per_page Seite der Kommentare, höchstens 50 je Seite
posts_order oldest (Standard) oder newest
attachments_page Seite der Anhänge, je 10
full_text die ganze Beschreibung, bis 100.000 Zeichen
post_id nur dieser eine Kommentar, bis 100.000 Zeichen

Beschreibung und Kommentare kommen auf höchstens 8.000 Zeichen gekürzt. full_text holt die Beschreibung, post_id einen Kommentar, jeweils bis 100.000 Zeichen. Bei einem Anhang des Tickets kommen bis zu 4.000 Zeichen des ausgelesenen Texts mit, mehr gibt es dafür nicht. text_status sagt, ob er vorliegt:

text_status Bedeutung
available Text ist lesbar
empty Datei wurde gelesen und enthält keinen Text, etwa ein Scan
unavailable noch nicht ausgelesen oder fehlgeschlagen, kann später klappen
unsupported aus diesem Dateityp liest Lalabase keinen Text

Dateien an einem Kommentar stehen dort mit Name, Typ und Größe, ihr Text kommt nicht mit.

Ticket anlegen: create_ticket

Argument Bedeutung
title Pflicht, eine Zeile, höchstens 255 Zeichen
description Text des Tickets
ticket_type Typ, Standard ist support
summary Kurzfassung in einer Zeile
status Startstatus, ein Schlüssel aus meta.available_statuses

Kommentieren: post_comment

Argument Bedeutung
ticket_id Pflicht, die ID des Tickets
body Pflicht, der Text
format html (Standard) oder plain für reinen Text
is_private true: nur du und die Konto-Administratoren seht den Kommentar

Ein Kommentar über MCP ist ein normaler Kommentar: Er erscheint in der Aktivität und löst dieselben Benachrichtigungen aus wie einer aus der App. Markdown wird nicht umgewandelt.

Ändern: update_ticket

Ein Aufruf ändert genau eine Sache, sonst lehnt Lalabase ihn ab:

Argument Ändert
ticket_id nichts, ist aber Pflicht: die ID, eine Nummer geht hier nicht
title den Titel
status den Status, als Schlüssel aus meta.available_statuses, nicht als Anzeigename
add_assignee_ids, remove_assignee_ids die Zuweisung, alle anderen bleiben zugewiesen; me steht für dich, höchstens 50 IDs

Sollen Status und Zuweisung sich ändern, macht der Agent zwei Aufrufe. Er ändert dabei dieselben Dinge auf demselben Weg wie das Board.