Code2Des Trigger

POST /api/v1/organizations/{organization_id}/projects/{project_id}/code2des

既存の completed Page Import から deterministic conversion job を作成します。この endpoint は URL を開かず、capture も行いません。Project Write 権限が必要です。

{
  "pageImportId": "019ffa75-01c0-75a2-8123-456789abcdef",
  "figmaFileKey": "aBc123",
  "screenId": "example.com/",
  "placementTarget": "128:9001"
}

figmaFileKey の default は unassigned、placementTarget は optional です。Page Import は同じ organization/project 内に存在し、completed で、resultUrl と captureHash の両方を持つ必要があります。満たさない場合は Code2Des row を作成せず 404 を返します。

Valid call ごとに新しい Code2Des job を作成するため、1 件の Page Import から複数 generation を作成でき、以前の Figma output は上書きされません。

201 response

{
  "code2desId": "019ffa75-01c0-75a2-8123-456789abcdf0",
  "pageImportId": "019ffa75-01c0-75a2-8123-456789abcdef",
  "status": "0",
  "attempt": 1,
  "createdAt": "2026-08-21T00:00:00.000Z"
}

Backend は completed capture の URL/hash を Code2Des worker に直接送ります。Enqueue が失敗した場合は新しい Code2Des row だけを failed にし、再利用可能な Page Import は completed のままです。