Deployment の実行

POST /api/v1/cloud/deployments/{id}/run Deployment Run を手動でトリガーします。Deployment は active ステータス(一時停止やアーカイブ済みではない) である必要があります。CAS が Run のセッションを作成できなかった場合、返される Deployment Run の session_id は null になり、error オブジェクトが含まれます。

パスパラメータ

パラメータ	型	説明
`id`	string	Deployment ID(`dep_` プレフィックス)

ヘッダー

名称	必須	値
`Authorization`	はい	`Bearer $QODER_PAT`
`Content-Type`	はい	`application/json`

リクエストボディ

リクエストボディは不要です。空の JSON オブジェクト {} を送るか、ボディを省略してください。

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/deployments/dep_019ec556114c78f8b60ee34fcb98bf59/run" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json"

レスポンス例

HTTP 200 OK Deployment Run オブジェクトを返します。

{
  "agent": {
    "id": "agent_019eb4d4a06d747c865d5800b9c57ae2",
    "type": "agent",
    "version": 1
  },
  "created_at": "2026-06-14T08:54:06Z",
  "deployment_id": "dep_019ec556114c78f8b60ee34fcb98bf59",
  "error": null,
  "id": "drun_019ec55694c07f2a9b402ffb4448ec18",
  "session_id": "sess_019ec55694c47605a8904c8f3d842ccb",
  "trigger_context": {
    "type": "manual"
  },
  "type": "deployment_run"
}

レスポンスフィールド (Deployment Run)

フィールド	型	説明
`id`	string	Run の一意識別子(`drun_` プレフィックス)
`type`	string	固定値 `"deployment_run"`
`deployment_id`	string	親 Deployment ID
`agent`	object	Agent 参照: `{id, type, version}`
`error`	object or null	セッションの作成に失敗した場合のエラー詳細(`{message, type}`)、`session_id` が存在する場合は null
`trigger_context`	object	トリガーソース: `{"type": "manual"}` または `{"type": "schedule", "scheduled_at": "..."}`
`session_id`	string or null	関連付けられた Session ID。公開される行では `session_id` または `error` のいずれか一方のみが出現します。
`created_at`	string	レコード作成時刻(ISO 8601)

エラー

HTTP	type	説明
401	`authentication_error`	PAT が無効または期限切れ
404	`not_found_error`	Deployment が存在しない
409	`conflict_error`	Deployment がアーカイブ済みまたは `active` ステータスでない

完全なエラーエンベロープについてはエラーを参照してください。

Deployment Run 一覧

この Deployment の実行履歴を一覧で取得します。

Deployment Run の取得

特定の Run の詳細とステータスを取得します。

全 Deployment Run 一覧

すべての Deployment にまたがる Run を確認します。

Deployment の取得

Deployment 設定と次回のスケジュール時刻を確認します。

​パスパラメータ

​ヘッダー

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンスフィールド (Deployment Run)

​エラー

​関連項目