Einreichungen

Einreichungen sind die Bug-Meldungen und Feature-Wünsche Ihres Projekts — dieselben Posts, die Ihre Nutzer im Portal anlegen, per API les- und schreibbar. (Allgemeines Feedback hat einen eigenen Endpunkt; siehe Feedback.)

Alle Endpunkte erfordern Authentifizierung und gelten für das Projekt des API-Schlüssels.

Einreichungen auflisten

GET/v1/submissions

Parameter	Type	Description
`status`	`string`	Nach Status filtern: open, planned, in_progress oder done.
`type`	`string`	Nach Typ filtern: bug oder feature.
`limit`	`integer`	Seitengröße. Standard: 20.
`offset`	`integer`	Anzahl zu überspringender Einträge. Standard: 0.


curl "https://api.supdesk.app/v1/submissions?status=open&limit=10" \
  -H "Authorization: Bearer sd_live_..."

Antworten nutzen den Standard-Listen-Umschlag:


{
  "data": [
    {
      "id": "8f7a…",
      "type": "bug",
      "title": "Export-Button reagiert in Safari nicht",
      "body": "Klick auf Export tut in Safari 26 nichts.",
      "status": "open",
      "created_at": "2026-07-01T09:12:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "has_more": false }
}

Einreichung abrufen

GET/v1/submissions/:id

Liefert eine einzelne Einreichung als { "data": { … } } oder einen 404 not_found-Fehler.

Einreichung erstellen

Pro Schreibzugriff erfordert einen Bezahltarif; im Free-Tarif kommt 403 forbidden zurück.

POST/v1/submissions

Parameter	Type	Description
`type`required	`string`	bug oder feature.
`title`required	`string`	Kurze Zusammenfassung der Einreichung.
`email`required	`string`	E-Mail des Endnutzers, zu dem die Einreichung gehört.
`body`	`string`	Ausführlichere Beschreibung.
`name`	`string`	Anzeigename des Endnutzers.


curl -X POST https://api.supdesk.app/v1/submissions \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "title": "Export-Button reagiert in Safari nicht",
    "email": "jamie@example.com",
    "body": "Klick auf Export tut in Safari 26 nichts."
  }'

Liefert 201 mit der erstellten Einreichung. Der Endnutzer wird automatisch in der Kundenliste Ihres Projekts angelegt (oder per E-Mail zugeordnet).

Erstellte Einreichungen zählen genau wie Portal-Einreichungen auf Ihr monatliches Kontingent. Am Limit liefert dieser Endpunkt 429 limit_reached — außer Ihr Workspace hat Einreichungs-Overage aktiviert, dann wird die Einreichung angenommen und abgerechnet. Siehe Rate-Limits & Nutzung.