メインコンテンツへスキップ
POST /v1/deployments/{id}/run Deployment Run を手動でトリガーします。Deployment は active ステータス(一時停止やアーカイブ済みではない) である必要があります。最大同時実行数の上限に達している場合、Run は skipped ステータスで記録されます。

​
パスパラメータ

パラメータ型説明
idstringDeployment 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
  },
  "cas_run_extras": {
    "attempt": 1,
    "started_at": "2026-06-14T08:54:06.310253147Z",
    "turn_id": "turn_019ec55694cb76249bc9ba56bf13a15c"
  },
  "created_at": "2026-06-14T08:54:06.271902633Z",
  "deployment_id": "dep_019ec556114c78f8b60ee34fcb98bf59",
  "error": null,
  "id": "drun_019ec55694c07f2a9b402ffb4448ec18",
  "session_id": "sess_019ec55694c47605a8904c8f3d842ccb",
  "status": "running",
  "trigger_context": {
    "type": "manual"
  },
  "triggered_at": "2026-06-14T08:54:06.271902633Z",
  "type": "deployment_run"
}

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

フィールド型説明
idstringRun の一意識別子(drun_ プレフィックス)
typestring固定値 "deployment_run"
deployment_idstring親 Deployment ID
agentobjectAgent 参照: {id, type, version}
statusstringRun ステータス: pending、running、completed、failed、skipped
errorobject or null失敗時のエラー詳細({message, type})、それ以外は null
trigger_contextobjectトリガーソース: {"type": "manual"}、{"type": "schedule"}、または {"type": "retry"}
session_idstring関連付けられた Session ID(Session 作成後に出現)
completed_atstring完了タイムスタンプ(ISO 8601、終了状態で出現)
duration_msintegerRun の実行時間(ミリ秒、完了時に出現)
cas_run_extrasobjectCAS 固有メタデータ: attempt、turn_id、started_at
triggered_atstringトリガータイムスタンプ(ISO 8601)
created_atstringレコード作成時刻(ISO 8601)

​
エラー

HTTPtype説明
401authentication_errorPAT が無効または期限切れ
404not_found_errorDeployment が存在しない
409conflict_errorDeployment がアーカイブ済みまたは active ステータスでない
完全なエラーエンベロープについては エラー を参照してください。

​
関連項目

Deployment Run 一覧

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

Deployment Run の取得

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

全 Deployment Run 一覧

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

Deployment の取得

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