Geplante Wartung: Sonntag, 29. November, von 04:00 bis 06:00 Uhr (UTC). Während wir unsere Server aktualisieren, ist Drag möglicherweise nicht erreichbar.
Mit der REST-API von DragApp interagieren Sie programmatisch mit Ihren Boards, Spalten, Karten, Tags und E-Mail-Sequenzen. Bauen Sie Integrationen, automatisieren Sie Workflows und synchronisieren Sie Drag mit Ihren bestehenden Tools.
Die DragApp-API authentifiziert Anfragen mit API-Schlüsseln. Übergeben Sie Ihren API-Schlüssel im Header Autorisierung Header jeder Anfrage.
Ihren API-Schlüssel finden Sie in den Einstellungen in Drag. Wenn Sie noch kein Konto haben, hier registrieren.
curl --request GET \
--url https://app.dragapp.com/v2/board \
--header 'Authorization: YOUR_API_KEY'Bewahren Sie Ihren API-Schlüssel sicher auf. Teilen Sie ihn nicht öffentlich und committen Sie ihn nicht in die Versionskontrolle.
Alle Endpunkte sind relativ zu dieser Basis-URL:
https://app.dragapp.com/v2/Alle Antworten liefern JSON mit einheitlicher Struktur. Codes im 200er-Bereich bedeuten Erfolg. Codes im 400er-Bereich weisen auf einen Fehler in der Anfrage hin.
{
"message": "Success message",
"error": false,
"code": 200,
"data": { ... }
}{
"message": "Error message",
"code": 400,
"error": true
}| Code | Beschreibung |
|---|---|
| 200 | OK. Anfrage erfolgreich. |
| 400 | Bad Request. Ungültige Parameter. |
| 401 | Nicht autorisiert. API-Schlüssel ungültig oder fehlt. |
| 403 | Zugriff verweigert. Unzureichende Berechtigungen. |
| 404 | Not Found. Die Ressource existiert nicht. |
| 429 | Rate Limited. Zu viele Anfragen. |
| 500 | Serverfehler. Bei uns ist etwas schiefgelaufen. |
Boards sind die Container der obersten Ebene in Drag. Jedes Board entspricht einem gemeinsamen Postfach oder einem Aufgaben-Workspace in Gmail.
/v2/board/v2/board/:id/v2/boardErstellt ein Board in Ihrem Gmail.
Parameter
NamestringErforderlichName des Boards
Beispiel: „Support-Board“
NutzerlistOptionalListe der Nutzer-E-Mails
Beispiel: ["aj@dragapp.com"]
{
"message": "Board created successfully",
"error": false,
"code": 200,
"data": {
"Id": 404303,
"BoardName": "Testing V2 Board"
}
}Alle Board-Typen auflisten.
Keine Parameter.
{
"message": "Board list",
"error": false,
"code": 200,
"data": [
{
"Id": 162461,
"Name": "A's Inbox",
"Owner": "aj@dragapp.com",
"Users": "akdev013@gmail.com"
}
]
}Details eines einzelnen Boards abrufen.
Keine Body-Parameter. Übergeben Sie die Board-ID im URL-Pfad.
{
"message": "Board details",
"error": false,
"code": 200,
"data": {
"Id": 162461,
"Name": "A's Inbox",
"Owner": "aj@dragapp.com",
"Users": "akdev013@gmail.com"
}
}Spalten stehen für die Phasen Ihres Kanban-Boards (z. B. Zu erledigen, In Arbeit, Erledigt). Jede Spalte gehört zu einem Board.
/v2/board/:boardId/columns/v2/board/:boardId/column/:id/v2/board/:boardId/column/:columnId/cards/v2/board/:boardId/columnErstellt eine Spalte in einem Board.
Parameter
NamestringErforderlichName der Spalte
Beispiel: „Zu erledigen“
{
"message": "Column created successfully",
"error": false,
"code": 200,
"data": {
"Success": "Column created successfully."
}
}Alle Spalten eines Boards auflisten.
Keine Body-Parameter.
{
"message": "Columns list",
"error": false,
"code": 200,
"data": [
{ "Id": 158415, "ColumnId": "Label_1", "Name": "To Do" },
{ "Id": 158416, "ColumnId": "Label_2", "Name": "Doing" },
{ "Id": 158417, "ColumnId": "Label_3", "Name": "Done" }
]
}Alle Karten einer Spalte auflisten. Unterstützt Paginierung.
Parameter
pagenumberErforderlichSeitenzahl
Beispiel: 1
limitstringOptionalAnzahl der Karten pro Seite
Beispiel: "10"
{
"message": "Column cards",
"error": false,
"code": 200,
"data": [
{
"DragTaskId": 200442,
"TaskName": "Task",
"ReadUnreadStatus": 1,
"ColumnId": "Label_1",
"BoardId": 404302,
"DueDate": null,
"Assignees": null,
"ThreadOwnerEmail": "aj@dragapp.com",
"CreatedAt": "2023-10-31T04:38:31.000Z",
"Status": "1",
"CustomFields": "[{}]"
}
]
}Karten stehen für einzelne Aufgaben oder E-Mail-Konversationen auf einem Board. Karten können Notizen, Kommentare, Unteraufgaben, Tags und Zuständige haben.
/v2/card/:id/v2/card/v2/card/:cardId/v2/card/move-card/v2/card/:cardId/v2/card/:cardId/note/v2/card/:cardId/tags/v2/card/:cardId/sub-taskErstellt eine Karte auf einem Board.
Parameter
BoardIdnumberErforderlichBoard, auf dem die Karte eingefügt werden soll
Beispiel: 20841
ColumnIdnumberErforderlichBoard-Spalte, in die die Karte eingefügt werden soll
Beispiel: 1094
CardTitlestringErforderlichKartentitel
Beispiel: „Planungsaufgabe“
NotizstringOptionalNotiz, die der Karte hinzugefügt wird
KommentarstringOptionalKommentar, der zur Karte hinzugefügt werden soll
UnteraufgabestringOptionalUnteraufgabe, die der Karte hinzugefügt wird
ZuständiglistOptionalE-Mail der zuständigen Person, oder null, um die Zuweisung aufzuheben
Beispiel: ["aj@dragapp.com"]
ReadStatusnumberOptionalGelesen = 1, Ungelesen = 0. Standard ist Gelesen.
Beispiel: 1
{
"Error": false,
"Success": "Task Added Successfully",
"taskId": 200433
}Eine bestehende Karte aktualisieren.
Parameter
BoardIdnumberErforderlichBoard, auf dem sich die Karte befindet
Beispiel: 20841
ColumnIdnumberErforderlichBoard-Spalte, in der sich die Karte befindet
Beispiel: 1094
CardTitlestringErforderlichKartentitel
Beispiel: „Planungsaufgabe“
NotizstringOptionalNotiz für die Karte
KommentarstringOptionalKommentar für die Karte
UnteraufgabestringOptionalUnteraufgabe für die Karte
ZuständiglistOptionalE-Mail der zuständigen Person, oder null, um die Zuweisung aufzuheben
Beispiel: ["aj@dragapp.com"]
{
"message": "Card updated successfully.",
"error": false,
"code": 200,
"data": "2451"
}Verschiebt eine Karte in eine andere Spalte oder ein anderes Board.
Parameter
IdstringErforderlichZu verschiebende Karte
Beispiel: "18ac0539048b4d0d"
NewBoardIdnumberOptionalBoard, auf das die Karte verschoben werden soll
Beispiel: 1094
NewColumnIdnumberErforderlichBoard-Spalte, in die die Karte verschoben werden soll
Beispiel: 1094
NewPositionnumberErforderlichPosition in der Spalte, an die Sie die Karte verschieben möchten
Beispiel: 0
{
"message": "Card moved successfully.",
"error": false,
"code": 200,
"data": "success"
}Einer Karte eine Notiz hinzufügen.
Parameter
TextstringErforderlichNotiz, die der Karte hinzugefügt wird
{
"message": "Note added to card successfully.",
"error": false,
"code": 200,
"data": { "CardId": "200429" }
}Einer Karte ein Tag hinzufügen.
Parameter
TagIdstringErforderlichTag, das der Karte hinzugefügt wird
Beispiel: "77155"
{
"message": "Added tag to card successfully.",
"error": false,
"code": 200,
"data": { "CardId": "200429" }
}Einer Karte eine Unteraufgabe hinzufügen.
Parameter
TextstringErforderlichUnteraufgabe, die der Karte hinzugefügt wird
Beispiel: „Unteraufgabe 1“
{
"message": "SubTask added to card successfully.",
"error": false,
"code": 200,
"data": { "CardId": "200429" }
}Eine Karte archivieren (löschen).
Keine Body-Parameter. Übergeben Sie die Karten-ID im URL-Pfad.
{
"message": "Card archived successfully.",
"error": false,
"code": 200,
"data": { "id": "43813" }
}E-Mail-Sequenzen sind automatisierte Follow-up-Ketten, die sich planen und nachverfolgen lassen.
/v2/email-sequence/v2/email-sequence/:idKeine Parameter.
{
"EmailTemplateId": 153783,
"UserId": 1000075,
"Name": "Welcome Email Sequence",
"CreatedAt": "2023-11-02T15:59:00.000Z",
"Content": "<p>Hello {{firstName}}, ...</p>",
"Subject": "Welcome Email",
"EmailFollowupId": 8393,
"TotalViewCount": 0,
"LastSent": null,
"OwnerName": "A J",
"OwnerEmail": "aj@dragapp.com"
}Eine einzelne E-Mail-Sequenz mit allen Follow-up-Schritten abrufen.
Keine Body-Parameter. Übergeben Sie die Sequenz-ID im URL-Pfad.
{
"Id": "153783",
"Name": "Welcome Email Sequence",
"CreatedAt": "2023-11-02T15:59:00.000Z",
"EmailFollowups": [
{
"EmailFollowupId": 8393,
"Subject": "Welcome Email",
"Content": "<p>Hello {{firstName}}, ...</p>",
"Days": 1,
"Duration": "days",
"Hours": 3,
"Minutes": 30,
"Sequence": 1
},
{
"EmailFollowupId": 8394,
"Subject": "Re: Welcome Email",
"Days": 1,
"Duration": "days",
"Sequence": 2
}
]
}Für alle API-Endpunkte gelten Rate Limits. Wenn Sie eine 429 als Statuscode erhalten, reduzieren Sie die Häufigkeit Ihrer Anfragen und versuchen Sie es mit exponentiellem Backoff erneut.
CLI & offizielle SDKs
Demnächst
MCP (Model Context Protocol)Live
47 Tools für Claude, ChatGPT, Gemini, Copilot, Cursor und mehr
Help Center: Leitfäden, Tutorials und FAQs
API-Dokumentation direkt in der App: interaktive API-Referenz in Ihrem DragApp-Konto
support@dragapp.com: direkter Kontakt zum Team
Kommentare
Kommentare sind interne Teamnachrichten, die an Karten hängen.
/v2/comment/v2/comment/:commentId/v2/comment/:commentId/v2/comment/:commentIdKommentar hinzufügen
Parameter
CardIdstringErforderlichKarte, zu der der Kommentar hinzugefügt werden soll
Beispiel: "77155"
TextstringErforderlichKommentar, der zur Karte hinzugefügt werden soll
Kommentar aktualisieren
Parameter
TextstringErforderlichZu aktualisierender Kommentar