SupDesk
POST/v1/submissions

Create a submission

Creates a new submission for a bug or feature report. Supply type, title, and a valid email; you can also include the reporter's name, locale, and device context. A 201 response returns the created submission.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

7 body fields

Submission details. type, title, and email are required.

typestringrequired
The submission type: bug or feature.
Allowed:bugfeature
titlestringrequired
The title of the submission.
bodystringoptional
The description or details of the submission.
emailstringrequired
The reporter's email address in a valid email format.
namestringoptional
The reporter's name.
localestringoptional
The reporter's locale.
deviceobjectoptional
Optional device/OS context for the reporting end user. Supplied values win per-field over the parsed User-Agent; the stored context is returned as device_context.

3 status codes
201Returns the created submission in the `data` object.
dataobjectoptional
401Returned when the request is not authenticated.
errorobjectoptional
429Returned when the request is rate limited.
errorobjectoptional

Error handling

A 401 is returned when the request is not authenticated, and a 429 is returned when the request is rate limited. type, title, and email are required; type must be bug or feature, and email must use a valid email format.