Invii

Gli invii sono i tuoi bug report e richieste di funzionalità — gli stessi post che i tuoi utenti creano sul portale, esposti per la lettura e la scrittura tramite l’API. (Il feedback generico ha il proprio endpoint; vedi Feedback.)

Tutti gli endpoint richiedono autenticazione e sono limitati al progetto della chiave API.

Elencare gli invii

GET/v1/submissions

Parameter	Type	Description
`status`	`string`	Filtra per stato: backlog, open, planned, in_progress, o done.
`type`	`string`	Filtra per tipo: bug o feature.
`limit`	`integer`	Dimensione pagina. Default 20.
`offset`	`integer`	Numero di elementi da saltare. Default 0.


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

Le risposte usano l’envelope della lista standard:


{
  "data": [
    {
      "id": "8f7a…",
      "type": "bug",
      "title": "Export button unresponsive on Safari",
      "body": "Clicking Export does nothing on Safari 26.",
      "status": "open",
      "is_private": false,
      "created_at": "2026-07-01T09:12:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "has_more": false }
}

Ottenere un invio

GET/v1/submissions/:id

Restituisce un singolo invio come { "data": { … } }, o un errore 404 not_found.

Creare un invio

Pro L’accesso in scrittura richiede un piano a pagamento; su Free restituisce 403 forbidden.

POST/v1/submissions

Parameter	Type	Description
`type`required	`string`	bug o feature.
`title`required	`string`	Riassunto breve dell'invio.
`email`required	`string`	Email dell'utente finale a cui appartiene l'invio.
`body`	`string`	Descrizione più lunga.
`name`	`string`	Nome visualizzato per l'utente finale.
`locale`	`string`	Lingua delle email di notifica generate (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Predefinito: en.


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 unresponsive on Safari",
    "email": "jamie@example.com",
    "body": "Clicking Export does nothing on Safari 26."
  }'

Restituisce 201 con l’invio creato. L’utente finale viene creato (o corrisposto per email) nella tua lista clienti automaticamente.

Gli invii creati contano verso il tuo quota mensile di invii esattamente come gli invii dal portale. Al limite, questo endpoint restituisce 429 limit_reached — a meno che lo spazio di lavoro non abbia overage per gli invii attivato, in quel caso l’invio viene accettato e fatturato. Vedi Limiti di velocità e utilizzo.