Envíos

Los envíos son los reportes de bugs y las peticiones de funcionalidades de tu proyecto — los mismos posts que tus usuarios crean en el portal, expuestos para lectura y escritura por la API. (El feedback general tiene su propio endpoint; ver Feedback.)

Todos los endpoints requieren autenticación y están limitados al proyecto de la clave de API.

Listar envíos

GET/v1/submissions

Parameter	Type	Description
`status`	`string`	Filtrar por estado: backlog, open, planned, in_progress o done.
`type`	`string`	Filtrar por tipo: bug o feature.
`limit`	`integer`	Tamaño de página. Por defecto 20.
`offset`	`integer`	Número de elementos a saltar. Por defecto 0.


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

Las respuestas usan el sobre de lista estándar:


{
  "data": [
    {
      "id": "8f7a…",
      "type": "bug",
      "title": "El botón Exportar no responde en Safari",
      "body": "Hacer clic en Exportar no hace nada en Safari 26.",
      "status": "open",
      "is_private": false,
      "created_at": "2026-07-01T09:12:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "has_more": false }
}

Obtener un envío

GET/v1/submissions/:id

Devuelve un único envío como { "data": { … } }, o un error 404 not_found.

Crear un envío

Pro La escritura requiere un plan de pago; en Free devuelve 403 forbidden.

POST/v1/submissions

Parameter	Type	Description
`type`required	`string`	bug o feature.
`title`required	`string`	Resumen breve del envío.
`email`required	`string`	Email del usuario final al que pertenece el envío.
`body`	`string`	Descripción más larga.
`name`	`string`	Nombre visible del usuario final.
`locale`	`string`	Idioma de los emails de notificación que dispara (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Por defecto: en.


curl -X POST https://api.supdesk.app/v1/submissions \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "title": "El botón Exportar no responde en Safari",
    "email": "jamie@example.com",
    "body": "Hacer clic en Exportar no hace nada en Safari 26."
  }'

Devuelve 201 con el envío creado. El usuario final se crea (o se asocia por email) automáticamente en la lista de clientes de tu proyecto.

Los envíos creados cuentan para tu cuota mensual de envíos exactamente igual que los del portal. En el límite, este endpoint devuelve 429 limit_reached — salvo que tu workspace tenga activado el excedente de envíos, en cuyo caso el envío se acepta y se factura. Ver Límites de tasa y uso.