生成コード再キュー

Target migration note: この endpoint は guinness-ai-v2/apps/des2code を再起動してはいけません。Des2Code の再実行は Des2Code API または MCP v2 から行い、完了は AI status webhook で返ります。

メソッド

RESTメソッドを採用しています。

HTTPメソッド

POST: 失敗した生成コードの再キュー

命名規則

クエリパラメータとノードの命名を統一し、可読性を向上させるため、リクエスト時のURIとJSON内のノードにはsnake_caseを使用します。

リクエストとレスポンス

ヘッダー

メタ情報はレスポンスボディではなく、HTTPヘッダーに設定されます。

リクエストヘッダー

Authorization
Content-Type
Accept
Accept-language

レスポンスヘッダー

Content-Type

生成コード再キュー

URI

POST /v1/organizations/{organization_id}/projects/{project_id}/generated_codes/{code_id}/requeue

パスパラメータ

名前	型	必須	説明
organization_id	string	必須	組織UUID
project_id	string	必須	プロジェクトUUID
code_id	string	必須	生成コードUUID

リクエストボディ

リクエストボディは不要です。

レスポンス

レスポンスはJSONです。

{
  "message": "Code generation requeued successfully",
  "id": "generated-code-uuid",
  "status": 0
}

レスポンスフィールド

名前	型	説明
message	string	成功メッセージ
id	string	生成コードUUID
status	number	新しいステータス（0: 保留中）

認証

認証はAmazon Cognitoから発行されるJSON Web Tokens (JWT)を使用して行われます。

例外処理

例外処理のステータスコードは以下の通りです。

説明	ステータスコード	ステータス名
認証情報不足	401	Unauthorized
実行権限不足	403	Forbidden
生成コード、プロジェクト、または組織が見つかりません	404	Not Found
内部サーバーエラー	500	Internal Server Error

処理フロー

パスパラメータから組織ID、プロジェクトID、コードIDを抽出
ユーザーがプロジェクトへのアクセス権を持つか検証
生成コードが指定されたプロジェクトに属していることを検証
ステータスを0（保留中）にリセット
retained legacy generated-code workflow のみ再トリガーする。des2code queue には送らない
成功メッセージを返却

詳細フローチャート

flowchart TD
    Start([POST requeue]) --> Auth[認証・パラメータ取得]
    Auth --> Service[Service Layer]
    Service --> AccessCheck[権限チェック]
    AccessCheck --> HasAccess{Write権限?}
    HasAccess -->|なし| Err404[404 Not Found]
    HasAccess -->|あり| CheckExist[既存確認]
    CheckExist --> Exists{存在?}
    Exists -->|なし| Err404
    Exists -->|あり| ResetStatus[status=0に更新<br/>pending]
    ResetStatus --> TriggerProcess[retained legacy workflow を再トリガー]
    TriggerProcess --> Success[200 OK<br/>Requeued successfully]

使用目的

この endpoint は legacy generated-code workflow を保持する場合にのみ使用します。ステータスが 0（pending）にリセットされ、その workflow が再処理します。target guinness-ai-v2 Des2Code path には含めません。