提出

提出はプロジェクトのバグレポートと機能要望です — ユーザーがポータルで作成する投稿と同じもので、API経由で読み書きできます。（一般的なフィードバックは別のエンドポイントがあります；フィードバックを参照ください。）

すべてのエンドポイントは認証を要求し、APIキーのプロジェクトに限定されます。

提出一覧

GET/v1/submissions

Parameter	Type	Description
`status`	`string`	フィルタ：backlog、open、planned、in_progress、またはdone。
`type`	`string`	フィルタ：bugまたはfeature。
`limit`	`integer`	ページサイズ。デフォルト20。
`offset`	`integer`	スキップするアイテム数。デフォルト0。


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

応答は標準のリスト envelopes を使用します：


{
  "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 }
}

提出の取得

GET/v1/submissions/:id

単一の提出を{ "data": { … } }として返し、存在しない場合は404 not_foundエラーを返します。

提出の作成

Pro 書き込みアクセスは有料プランが必要です。Freeでは403 forbiddenを返します。

POST/v1/submissions

Parameter	Type	Description
`type`required	`string`	bugまたはfeature。
`title`required	`string`	提出の短い要約。
`email`required	`string`	提出に属するエンドユーザーのメール。
`body`	`string`	より長い説明。
`name`	`string`	エンドユーザーの表示名。
`locale`	`string`	送信される通知メールの言語（en, ar, de, es, fr, he, hi, it, ja, ru, zh）。既定は 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."
  }'

201を返し、作成された提出を含みます。エンドユーザーはメールで一致するか、顧客に自動的に作成されます。

作成された提出はポータル提出と同様に月間提出数枠にカウントされます。枠に達すると、このエンドポイントは429 limit_reachedを返します — ただし、ワークスペースが提出数オーバーを有効にしている場合は提出が受け付けられ、請求されます。レート制限と利用状況を参照ください。