Soumissions

Les soumissions sont les rapports de bugs et demandes de fonctionnalités de votre projet — les mêmes posts que vos utilisateurs créent sur le portail, exposés en lecture et en écriture via l’API. (Le feedback général a son propre endpoint ; voir Feedback.)

Tous les endpoints exigent une authentification et sont limités au projet de la clé d’API.

Lister les soumissions

GET/v1/submissions

Parameter	Type	Description
`status`	`string`	Filtrer par statut : backlog, open, planned, in_progress ou done.
`type`	`string`	Filtrer par type : bug ou feature.
`limit`	`integer`	Taille de page. 20 par défaut.
`offset`	`integer`	Nombre d'éléments à sauter. 0 par défaut.


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

Les réponses utilisent l’enveloppe de liste standard :


{
  "data": [
    {
      "id": "8f7a…",
      "type": "bug",
      "title": "Le bouton Exporter ne répond pas sous Safari",
      "body": "Cliquer sur Exporter ne fait rien sous Safari 26.",
      "status": "open",
      "is_private": false,
      "created_at": "2026-07-01T09:12:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "has_more": false }
}

Récupérer une soumission

GET/v1/submissions/:id

Renvoie une seule soumission sous la forme { "data": { … } }, ou une erreur 404 not_found.

Créer une soumission

Pro L’écriture exige une formule payante ; en Free, cela renvoie 403 forbidden.

POST/v1/submissions

Parameter	Type	Description
`type`required	`string`	bug ou feature.
`title`required	`string`	Résumé court de la soumission.
`email`required	`string`	E-mail de l'utilisateur final auquel appartient la soumission.
`body`	`string`	Description plus longue.
`name`	`string`	Nom d'affichage de l'utilisateur final.
`locale`	`string`	Langue des e-mails de notification déclenchés (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Par défaut : en.


curl -X POST https://api.supdesk.app/v1/submissions \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "title": "Le bouton Exporter ne répond pas sous Safari",
    "email": "jamie@example.com",
    "body": "Cliquer sur Exporter ne fait rien sous Safari 26."
  }'

Renvoie 201 avec la soumission créée. L’utilisateur final est créé (ou rapproché par e-mail) automatiquement dans la liste de clients de votre projet.

Les soumissions créées comptent dans votre quota mensuel de soumissions exactement comme celles du portail. Au plafond, cet endpoint renvoie 429 limit_reached — sauf si votre workspace a activé le dépassement de soumissions, auquel cas la soumission est acceptée et facturée. Voir Limites de débit et usage.