"x1":"6","x2":"6.01","y1":"6","y2":"6","key":"16zg32"}],["line",{"x1":"6","x2":"6.01","y1":"18","y2":"18","key":"nzw8ys"}]],"className":"lucide-server"}] bc:I[908637,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"DocsPage"] bd:I[908637,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"DocsTitle"] be:I[671704,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"MarkdownCopyButton"] bf:I[671704,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"ViewOptionsPopover"] c0:I[908637,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"DocsBody"] c1:I[485216,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"Heading"] c2:I[683013,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"default"] c3:I[455003,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"CodeBlock"] c4:I[455003,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"Pre"] c6:I[916821,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js","/_next/static/immutable/chunks/3gx2v--eqo4lc.js","/_next/static/immutable/chunks/0nlbvitw92jfg.js","/_next/static/immutable/chunks/1_a213lpw0enq.js","/_next/static/immutable/chunks/2og34vmquv382.js","/_next/static/immutable/chunks/102jjpbrmuti3.js","/_next/static/immutable/chunks/2f12o941xqbpt.js","/_next/static/immutable/chunks/1nqfygzx268lk.js","/_next/static/immutable/chunks/2-3g5_ruzqppp.js","/_next/static/immutable/chunks/0172xdrptfb3v.js","/_next/static/immutable/chunks/1ekoh85sp3357.js"],"OpenAPIPage"] c9:I[813531,["/_next/static/immutable/chunks/2ly1xud52gorb.js","/_next/static/immutable/chunks/2z5ah-obdzy9d.js","/_next/static/immutable/chunks/20g0-95go0z39.js"],"IconMark"] 10:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3","key":"wmoenq"}],["path",{"d":"M12 9v4","key":"juzpu7"}],["path",{"d":"M12 17h.01","key":"p32p05"}]],"className":"lucide-triangle-alert"}] 11:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M3 5h.01","key":"18ugdj"}],["path",{"d":"M3 12h.01","key":"nlz23k"}],["path",{"d":"M3 19h.01","key":"noohij"}],["path",{"d":"M8 5h13","key":"1pao27"}],["path",{"d":"M8 12h13","key":"1za7za"}],["path",{"d":"M8 19h13","key":"m83p4d"}]],"className":"lucide-list"}] 12:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M12 19h8","key":"baeox8"}],["path",{"d":"m4 17 6-6-6-6","key":"1yngyt"}]],"className":"lucide-terminal"}] 13:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$9:props:iconNode","className":"lucide-rocket"}] 14:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$a:props:iconNode","className":"lucide-key-round"}] 15:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$12:props:iconNode","className":"lucide-terminal"}] 16:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M12 8V4H8","key":"hb8ula"}],["rect",{"width":"16","height":"12","x":"4","y":"8","rx":"2","key":"enze0r"}],["path",{"d":"M2 14h2","key":"vft8re"}],["path",{"d":"M20 14h2","key":"4cs60a"}],["path",{"d":"M15 13v2","key":"1xurst"}],["path",{"d":"M9 13v2","key":"rq6x2g"}]],"className":"lucide-bot"}] 17:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8","key":"v9h5vc"}],["path",{"d":"M21 3v5h-5","key":"1q7to0"}],["path",{"d":"M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16","key":"3uifl3"}],["path",{"d":"M8 16H3v5","key":"1cv678"}]],"className":"lucide-refresh-cw"}] 18:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$12:props:iconNode","className":"lucide-terminal"}] 19:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M16 10a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 14.286V4a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z","key":"1n2ejm"}],["path",{"d":"M20 9a2 2 0 0 1 2 2v10.286a.71.71 0 0 1-1.212.502l-2.202-2.202A2 2 0 0 0 17.172 19H10a2 2 0 0 1-2-2v-1","key":"1qfcsi"}]],"className":"lucide-messages-square"}] 1a:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$9:props:iconNode","className":"lucide-rocket"}] 1b:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$a:props:iconNode","className":"lucide-key-round"}] 1c:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$19:props:iconNode","className":"lucide-messages-square"}] 1d:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z","key":"18887p"}],["path",{"d":"M7 11h10","key":"1twpyw"}],["path",{"d":"M7 15h6","key":"d9of3u"}],["path",{"d":"M7 7h8","key":"af5zfr"}]],"className":"lucide-message-square-text"}] 1e:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M16.247 7.761a6 6 0 0 1 0 8.478","key":"1fwjs5"}],["path",{"d":"M19.075 4.933a10 10 0 0 1 0 14.134","key":"ehdyv1"}],["path",{"d":"M4.925 19.067a10 10 0 0 1 0-14.134","key":"1q22gi"}],["path",{"d":"M7.753 16.239a6 6 0 0 1 0-8.478","key":"r2q7qm"}],["circle",{"cx":"12","cy":"12","r":"2","key":"1c9p78"}]],"className":"lucide-radio"}] 1f:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M2.97 12.92A2 2 0 0 0 2 14.63v3.24a2 2 0 0 0 .97 1.71l3 1.8a2 2 0 0 0 2.06 0L12 19v-5.5l-5-3-4.03 2.42Z","key":"lc1i9w"}],["path",{"d":"m7 16.5-4.74-2.85","key":"1o9zyk"}],["path",{"d":"m7 16.5 5-3","key":"va8pkn"}],["path",{"d":"M7 16.5v5.17","key":"jnp8gn"}],["path",{"d":"M12 13.5V19l3.97 2.38a2 2 0 0 0 2.06 0l3-1.8a2 2 0 0 0 .97-1.71v-3.24a2 2 0 0 0-.97-1.71L17 10.5l-5 3Z","key":"8zsnat"}],["path",{"d":"m17 16.5-5-3","key":"8arw3v"}],["path",{"d":"m17 16.5 4.74-2.85","key":"8rfmw"}],["path",{"d":"M17 16.5v5.17","key":"k6z78m"}],["path",{"d":"M7.97 4.42A2 2 0 0 0 7 6.13v4.37l5 3 5-3V6.13a2 2 0 0 0-.97-1.71l-3-1.8a2 2 0 0 0-2.06 0l-3 1.8Z","key":"1xygjf"}],["path",{"d":"M12 8 7.26 5.15","key":"1vbdud"}],["path",{"d":"m12 8 4.74-2.85","key":"3rx089"}],["path",{"d":"M12 13.5V8","key":"1io7kd"}]],"className":"lucide-boxes"}] 20:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M12 22v-5","key":"1ega77"}],["path",{"d":"M15 8V2","key":"18g5xt"}],["path",{"d":"M17 8a1 1 0 0 1 1 1v4a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1z","key":"1xoxul"}],["path",{"d":"M9 8V2","key":"14iosj"}]],"className":"lucide-plug"}] 21:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z","key":"zw3jo"}],["path",{"d":"M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12","key":"1wduqc"}],["path",{"d":"M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17","key":"kqbvx6"}]],"className":"lucide-layers"}] 22:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$9:props:iconNode","className":"lucide-rocket"}] 23:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z","key":"1oefj6"}],["path",{"d":"M14 2v5a1 1 0 0 0 1 1h5","key":"wfsgrz"}],["path",{"d":"M10 9H8","key":"b1mrlr"}],["path",{"d":"M16 13H8","key":"t4e002"}],["path",{"d":"M16 17H8","key":"z1uh3a"}]],"className":"lucide-file-text"}] 24:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$21:props:iconNode","className":"lucide-layers"}] 25:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z","key":"1oefj6"}],["path",{"d":"M14 2v5a1 1 0 0 0 1 1h5","key":"wfsgrz"}],["path",{"d":"m9 15 2 2 4-4","key":"1grp1n"}]],"className":"lucide-file-check"}] 26:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$21:props:iconNode","className":"lucide-layers"}] 27:["$","$Lb3",null,{"ref":"$undefined","iconNode":[["path",{"d":"M12 17V7","key":"pyj7ub"}],["path",{"d":"M16 8h-6a2 2 0 0 0 0 4h4a2 2 0 0 1 0 4H8","key":"1elt7d"}],["path",{"d":"M4 3a1 1 0 0 1 1-1 1.3 1.3 0 0 1 .7.2l.933.6a1.3 1.3 0 0 0 1.4 0l.934-.6a1.3 1.3 0 0 1 1.4 0l.933.6a1.3 1.3 0 0 0 1.4 0l.933-.6a1.3 1.3 0 0 1 1.4 0l.934.6a1.3 1.3 0 0 0 1.4 0l.933-.6A1.3 1.3 0 0 1 19 2a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1 1.3 1.3 0 0 1-.7-.2l-.933-.6a1.3 1.3 0 0 0-1.4 0l-.934.6a1.3 1.3 0 0 1-1.4 0l-.933-.6a1.3 1.3 0 0 0-1.4 0l-.933.6a1.3 1.3 0 0 1-1.4 0l-.934-.6a1.3 1.3 0 0 0-1.4 0l-.933.6a1.3 1.3 0 0 1-.7.2 1 1 0 0 1-1-1z","key":"ycz6yz"}]],"className":"lucide-receipt"}] 28:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$10:props:iconNode","className":"lucide-triangle-alert"}] 29:["$","$Lb3",null,{"ref":"$undefined","iconNode":"$19:props:iconNode","className":"lucide-messages-square"}] 2a:["Create the caller's profile and first org (idempotent)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2b:["Current user profile and org memberships"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2c:["Pending org invites addressed to the signed-in user's email"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2d:["Accept a pending org invite (session only)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2e:["Decline a pending org invite (session only)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 2f:["The current principal and the org it acts in"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 30:["Update the caller's profile"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 31:["List an org's members"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 32:["List an org's pending invites (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 33:["Revoke a pending invite (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 34:["Record the browser device the caller is signed in from"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 35:["Create an organization (caller becomes owner)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 36:["Get an organization"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 37:["Update an organization (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 38:["Delete (soft-delete) an organization (owner only)"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 39:["Invite a member by email (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 3a:["Update a member's role (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 3b:["Remove a member (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 3c:["Get a cluster by id"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3d:["Get a cluster with its replicas and GPU model"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3e:["List an org's clusters (cursor-paginated)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3f:["Create a cluster"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 40:["Stop a cluster"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 41:["Restart a cluster"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 42:["Terminate a cluster"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 43:["Scale a cluster's replica count"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 44:["List an org's VMs (cursor-paginated)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 45:["Get a VM by id"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 46:["Get a VM with its GPU/node/template info and price"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 47:["Live burn rate, session cost so far, and org runway for a VM"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 48:["GPU utilization, memory, power and temperature time series for a pod"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 4a:["Create a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 4b:["Stop a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 4c:["Restart a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 4d:["Terminate a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 4e:["Reboot a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 4f:["Set a VM's endpoint visibility"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 50:["Resize a stopped VM's disk"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 51:["Get a VM's embedded Telegram link"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 52:["SSH keys attached to a VM + the org's keys"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 53:["Attach an org SSH key to a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 54:["Detach an org SSH key from a VM"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 55:["List an org's pods (cursor-paginated)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 56:["Create a pod"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 57:["Live pod GPU capacity and on-demand rates"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 58:["Create a snapshot of a VM"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 59:["List an org's VM snapshots (optionally filtered by source VM)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5a:["Soft-delete a snapshot"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 5b:["Fork a new VM from a snapshot"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 5c:["List an org's SSH public keys"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5d:["Add an SSH public key (computes fingerprint)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 5e:["Delete an SSH public key"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 5f:["List an org's API keys (no secrets)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 60:["Create an API key (returns the plaintext once)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 61:["Revoke an API key"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 62:["List an org's registry credentials (no secrets)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 63:["Create a registry credential (credentials stored encrypted)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 64:["Delete a registry credential"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 65:["List an org's webhooks (no secrets)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 66:["Create a webhook (returns the signing secret once)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 67:["Update a webhook (name/url/events)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 68:["Delete a webhook"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 69:["Enable/disable a webhook"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6a:["Regenerate a webhook's signing secret (returned once)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6b:["Recent delivery attempts for a webhook"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 6c:["Org balance + recent transactions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 6d:["Start saving a card (Stripe SetupIntent for inline Elements)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6e:["Charge the saved card to top up prepaid balance"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6f:["Read the org's auto-recharge policy"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 70:["Set the org's auto-recharge policy"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 71:["List saved cards (brand/last4/exp only)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 72:["Remove a saved card"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 73:["Set a saved card as the default for charges"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 74:["Current-month usage (cents/hours + per gpuModel-tier breakdown)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 75:["Per-day spend over a trailing window (compute + inference segments)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 76:["Orgs the caller belongs to (for the transfer target dropdown)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 77:["Initiate a resource transfer to another org (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 78:["Pending incoming transfers (enriched)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 79:["Outgoing transfers, all statuses (enriched)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7a:["Count of pending incoming transfers"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7b:["Cancel a pending outgoing transfer (source org)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 7c:["Accept a pending incoming transfer (target org owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 7d:["Reject a pending incoming transfer (target org owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 7e:["One-command node onboarding installer (auth = org API key bearer, OR a pre-minted provisioning token via ?token=)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7f:["Provider status (isProvider + application status)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 80:["Submit a provider application"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 81:["List the org's provisioning tokens (provider only)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 82:["Generate a provisioning token (owner/admin session, provider org only)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 83:["Revoke a provisioning token (owner/admin)"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 84:["List the provider org's nodes (with GPUs + location)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 85:["Set a node's operator lifecycle status (drain / maintenance / remove / online)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 86:["Provider node + token stats"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 87:["Provider earnings from usage records (+ payout history)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 88:["Terminate spot workloads running on a node you own or manage"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 89:["List a node's GPU units, so you can reserve or release them"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8a:["List a node's reservations (platform admin)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8b:["Reserve GPU units on a node for a set of orgs (platform admin)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 8c:["Get one node reservation (platform admin)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8d:["Amend a reservation's term, audience, or topology pin (platform admin)"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 8e:["End a reservation now (platform admin)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 8f:["Release GPU units to the spot market (double sell)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 90:["Take released GPU units back off the market, evicting spot workloads"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 91:["What GPU capacity is reserved to this org, and until when"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 92:["List runner pools (with active/queued usage)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 93:["Create a runner pool"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 94:["GitHub connect URL (OAuth authorize when configured, else App install)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 95:["List GitHub installations the user can connect (OAuth code exchange)"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 96:["Get a runner pool (with usage)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 97:["Delete (or drain) a runner pool"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 98:["Resize a runner pool's RAM tier"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 99:["List runner jobs for a pool"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9a:["Runner pool job metrics (last 30 days) + cost comparison"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9b:["List models in the OpenRelay catalog (OpenAI-compatible)"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9c:["GPU availability by model"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9d:["GPU model catalog"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9e:["GPU + CPU pricing"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9f:["VM template catalog"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a0:["Locations / regions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a1:["List batches, newest first"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a2:["Create a batch inference job"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] a3:["Get a batch by id"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a4:["Cancel a running batch"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] a5:["Upload a JSONL input file for the Batch API"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] a6:["Mint a signed URL for a direct JSONL upload"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] a7:["Register a presigned upload after the PUT succeeds"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] a8:["Get a file's metadata"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a9:["Download a file's raw JSONL content"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] aa:[["$","svg",null,{"width":"22","height":"22","viewBox":"0 0 69 70","fill":"none","xmlns":"http://www.w3.org/2000/svg","aria-hidden":true,"children":[["$","path",null,{"d":"M60.5423 30.2967C60.7554 30.5394 60.6602 44.0453 60.6591 45.401C53.5033 50.5659 45.6063 55.8265 38.2931 60.7941L29.5066 66.7998C28.2194 67.6637 26.7208 68.7183 25.4115 69.487C23.1983 67.9516 20.1913 66.2204 17.8572 64.747C11.9256 61.0197 5.97318 57.3258 0 53.6655C0.572953 53.2939 1.3012 52.7265 1.86528 52.3122C6.13932 49.0833 10.7137 45.8909 15.088 42.7891C18.4694 40.3916 22.0099 37.8544 25.4665 35.5893C25.3483 37.0405 25.4462 40.3088 25.4465 41.8918L25.416 54.7226C31.7452 50.2935 38.0629 45.6805 44.4226 41.3312L53.5003 35.1095C55.6668 33.6491 58.496 31.8291 60.5423 30.2967Z","fill":"currentColor"}],["$","path",null,{"d":"M43.2795 4.48587e-05C43.8778 -0.028543 65.8362 13.6158 68.8187 15.2833C68.0238 15.7431 66.7922 16.6423 66.0081 17.1787L60.7643 20.7645C55.2356 24.5422 49.1623 28.7084 43.5426 32.3367C43.4356 26.689 43.5185 20.8236 43.5135 15.1528C40.5024 17.2817 36.5953 19.5448 33.4021 21.6804C25.0288 27.2417 15.9211 32.9351 7.86148 38.9164L7.86965 23.7155C8.76563 23.1865 10.333 22.01 11.2344 21.3838L17.6154 16.9922C25.7336 11.418 34.8295 5.03112 43.2795 4.48587e-05Z","fill":"currentColor"}]]}],["$","span",null,{"className":"font-semibold","children":"OpenRelay"}],["$","span",null,{"className":"text-fd-muted-foreground font-normal","children":"docs"}]] ab:["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}] ac:["$","$1","c",{"children":[null,["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}] ad:["$","$1","c",{"children":["$Lb4",[["$","script","script-0",{"src":"/_next/static/immutable/chunks/2f12o941xqbpt.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/immutable/chunks/1nqfygzx268lk.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/immutable/chunks/2-3g5_ruzqppp.js","async":true,"nonce":"$undefined"}],["$","script","script-3",{"src":"/_next/static/immutable/chunks/0172xdrptfb3v.js","async":true,"nonce":"$undefined"}],["$","script","script-4",{"src":"/_next/static/immutable/chunks/1ekoh85sp3357.js","async":true,"nonce":"$undefined"}]],["$","$Lb5",null,{"children":["$","$b6",null,{"name":"Next.MetadataOutlet","children":"$@b7"}]}]]}] af:["$","$1","h",{"children":[null,["$","$Lb8",null,{"children":"$Lb9"}],["$","div",null,{"hidden":true,"children":["$","$Lba",null,{"children":["$","$b6",null,{"name":"Next.Metadata","children":"$Lbb"}]}]}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}] b1:["$","link","0",{"rel":"stylesheet","href":"/_next/static/immutable/chunks/03wfpop5-72-a.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}] b2:["$","link","1",{"rel":"stylesheet","href":"/_next/static/immutable/chunks/1p7pfzgyy_3bz.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}] ae:C b4:["$","$Lbc",null,{"toc":[{"depth":2,"url":"#command-line","title":"Command line"}],"full":true,"children":[["$","$Lbd",null,{"children":"Remove a saved card"}],null,["$","div",null,{"className":"flex flex-row flex-wrap gap-2 items-center border-b pb-4 mb-4","children":[["$","$Lbe",null,{"markdownUrl":"/llms.mdx/docs/billing/deleteBillingPaymentMethod/content.md"}],["$","$Lbf",null,{"markdownUrl":"/llms.mdx/docs/billing/deleteBillingPaymentMethod/content.md"}]]}],["$","$Lc0",null,{"children":[["\n","\n",["$","$Lc1",null,{"as":"h2","id":"command-line","children":"Command line"}],"\n",["$","p",null,{"children":["The ",["$","$Lc2",null,{"href":"/docs/cli","children":[["$","code",null,{"children":"orl"}]," CLI"]}]," wraps this endpoint:"]}],"\n",["$","$Lc3",null,{"className":"shiki shiki-themes github-light github-dark","style":{"--shiki-light":"#24292e","--shiki-dark":"#e1e4e8","--shiki-light-bg":"#fff","--shiki-dark-bg":"#24292e"},"tabIndex":"0","icon":"","children":["$","$Lc4",null,{"children":["$","code",null,{"children":["$","span",null,{"className":"line","children":[["$","span",null,{"style":{"--shiki-light":"#6F42C1","--shiki-dark":"#B392F0"},"children":"orl"}],["$","span",null,{"style":{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},"children":" billing"}],["$","span",null,{"style":{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},"children":" payment-method"}],["$","span",null,{"style":{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},"children":" delete"}],["$","span",null,{"style":{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},"children":" <"}],["$","span",null,{"style":{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},"children":"payment-method-i"}],["$","span",null,{"style":{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},"children":"d"}],["$","span",null,{"style":{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},"children":">"}]]}]}]}]}]],"$Lc5"]}]]}] c7:T404,Browser signals the dashboard captured for this action: device intelligence from the Fingerprint JavaScript agent, and the reCAPTCHA v3 assessment of the same action. Every field is optional; a browser that blocked one vendor, both, or neither must reach the same 204. The two halves differ in what the server can do with them. The device fields are a CLAIM the control plane re-verifies with Fingerprint before it clusters on them. The captcha fields are a VERDICT the dashboard already reached against siteverify (a v3 token is single-use, so it cannot be re-checked here) and are recorded, never re-derived. The device half specifically: both fields are optional and CLIENT-REPORTED: the server records them and never refuses a request because of them or because they are missing. Send BOTH: the server checks the event id against Fingerprint's Server API, and only a confirmed pair is indexed, clustered, or used to raise a review flag. Anything it cannot confirm is kept as a claim and joins nothing (audit/FINGERPRINT.md).c8:T4db,Host-side NVIDIA telemetry for a pod's GPUs, sampled on the node that runs it and returned as one continuous time grid. Every series and every GPU in a response shares that grid: the value at index i of any values array was measured at start plus i times stepSeconds, and a null means the node reported no sample at that point. The window ends now and covers only the periods this pod actually held the GPUs it is reported against, so a card that ran another customer's pod earlier never contributes a sample here. A GPU attached to a VM is passed through to the guest, so the host cannot read it. That case answers 200 with an accelerator status of unavailable and an empty gpus list rather than an error, and so do a pod that has not started yet, a pod that was not running in the selected range, and a metrics store that cannot be reached: the accelerator object is the answer, and the client renders its detail sentence. A host that stopped reporting while the pod is still running answers degraded with the history up to the last sample still attached. This operation is exposed as an agent tool by default, in the same class as a pod's burn rate: "how busy were my GPUs" is a read-only question about a resource the caller already owns. c5:["$","$Lc6",null,{"document":"./openapi.processed.json","operations":[{"path":"/v1/orgs/{orgId}/billing/payment-methods/{paymentMethodId}","method":"delete"}],"preloaded":{"docs":{"./openapi.processed.json":{"openapi":"3.2.0","info":{"title":"OpenRelay API","version":"0.1.0","description":"The OpenRelay control-plane REST API. Deploy GPU VMs and inference clusters, manage organizations and billing, and automate your infrastructure. All requests are authenticated with an API key (`or_…`; legacy `vl_…` keys still work) unless noted otherwise.\n"},"servers":[{"url":"https://api.openrelay.inc","description":"Production"}],"tags":[{"name":"Account","description":"The signed-in user: profile, memberships, and first-time onboarding."},{"name":"Organizations","description":"Organizations and their members. Most resources are scoped to an org."},{"name":"Clusters","description":"Autoscaling inference clusters that serve a container image behind an endpoint."},{"name":"VMs","description":"GPU virtual machines: lifecycle, disks, SSH access, and console links."},{"name":"Pods","description":"GPU pods: bring-your-own-image containers on a whole GPU, with SSH access and an HTTP endpoint."},{"name":"Snapshots","description":"Point-in-time VM snapshots and forking new VMs from them."},{"name":"SSH Keys","description":"Org-level SSH public keys that can be attached to VMs."},{"name":"API Keys","description":"Programmatic access keys (or_…; legacy vl_… still valid) used to authenticate with this API."},{"name":"Registry Credentials","description":"Private container-registry credentials for pulling images."},{"name":"Webhooks","description":"Subscribe to platform events with signed HTTP callbacks."},{"name":"Billing","description":"Prepaid balance, saved cards, deposits, and auto-recharge."},{"name":"Usage","description":"Current-period usage and cost breakdowns."},{"name":"Transfers","description":"Move resources between organizations you belong to."},{"name":"Provider","description":"For GPU providers: applications, nodes, provisioning tokens, and earnings."},{"name":"Reservations","description":"Long-term reservations of specific GPU units on a node for a set of organizations. Reserved capacity is exclusive to its audience and hidden from everyone else.\n"},{"name":"Runners","description":"Managed GitHub Actions runner pools."},{"name":"Catalog","description":"Public catalog: GPU models, availability, pricing, templates, and locations."},{"name":"Batches","description":"Batch inference jobs: submit a JSONL file of requests, poll status, and download results at a discounted rate. Served by the inference endpoint (inference.openrelay.inc). Batch access is enabled per organization; without it these endpoints return 404.\n"},{"name":"Files","description":"Input and result files for the Batch API (JSONL, up to 200 MB and 50,000 records). Served by the inference endpoint (inference.openrelay.inc).\n"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"OpenRelay API key. Send it as `Authorization: Bearer or_…` (legacy `vl_…` keys still work)."}},"parameters":{"OrgId":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"}},"ResourceId":{"name":"id","in":"path","required":true,"schema":{"type":"string"}},"NodeId":{"name":"nodeId","in":"path","required":true,"schema":{"type":"string"}},"VmId":{"name":"vmId","in":"path","required":true,"schema":{"type":"string"}}},"schemas":{"Health":{"type":"object","required":["status","service"],"properties":{"status":{"type":"string"},"service":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}},"CreatedResource":{"type":"object","required":["id","name","status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}}},"PendingCount":{"type":"object","required":["count"],"properties":{"count":{"type":"integer"}}},"DeviceSignals":{"type":"object","description":"$c7","properties":{"deviceFingerprint":{"type":"string","maxLength":128,"description":"Fingerprint visitor id, the stable per-device identifier."},"deviceEventId":{"type":"string","maxLength":128,"description":"Fingerprint event id for this identification. It is the half the server verifies with Fingerprint (the visitor id alone cannot be), so a visitor id sent without it is recorded but never clustered."},"captchaScore":{"type":"number","minimum":0,"maximum":1,"description":"reCAPTCHA v3 score for the action behind this request, 0 to 1 (\"1.0 is very likely a good interaction, 0.0 is very likely a bot\", https://developers.google.com/recaptcha/docs/v3). The dashboard's server layer obtained it from Google's siteverify and checked the action, hostname, and challenge age before sending it, so this is a VERDICT the control plane records rather than a token it re-verifies. Absent when the feature is off or nothing could be measured, and an absent score is not a zero."},"captchaBand":{"type":"string","maxLength":32,"description":"Which threshold band the score fell in: \"pass\" (>= 0.7), \"step_up\" (0.3 to 0.7), or \"step_up_strict\" (< 0.3). The step-up the band demanded has ALREADY been satisfied by the time the request arrives, so this records how much friction the customer met; it is never an instruction. A deployment with the feature off sends no captcha fields at all rather than a band meaning \"we did not look\" (docs/architecture/signup-bot-defense.md)."},"captchaAction":{"type":"string","maxLength":64,"description":"The reCAPTCHA action the token was minted for (signup_password, signup_magic_link, signup_oauth, deposit, card_save). Already checked against siteverify's own `action`, which is what stops a token minted on the signup widget being replayed at the deposit endpoint."}}},"BootstrapRequest":{"type":"object","properties":{"orgName":{"type":"string"}}},"BootstrapResult":{"type":"object","required":["organizationId","role"],"properties":{"organizationId":{"type":"string"},"role":{"type":"string"}}},"UserProfile":{"type":"object","required":["id","email"],"properties":{"id":{"type":"string"},"email":{"type":"string"},"fullName":{"type":"string"},"avatarUrl":{"type":"string"},"defaultOrganizationId":{"type":"string"}}},"OrgFeatures":{"type":"object","required":["batch","publicEndpoint","fabric","perVmSshKeys"],"description":"Per-org feature entitlements the dashboard gates its UI on.","properties":{"batch":{"type":"boolean","description":"The org is allowlisted for the Batch API (batch-api.md §8)."},"perVmSshKeys":{"type":"boolean","description":"The org is allowlisted for per-VM SSH key scoping (the gateway honors each VM's sshKeyIds instead of accepting any org key). Gates the dashboard's per-VM key management (shadow rollout)."},"fabric":{"type":"boolean","description":"The org is allowlisted for the compute-fabric Pod product (FABRIC_ENABLED fleet-wide or FABRIC_ORGS). Gates the dashboard Pods surface (shadow rollout)."},"publicEndpoint":{"type":"boolean","deprecated":true,"description":"Vestigial, always false. The public-endpoint feature is GA (ungated); this field is kept only to avoid a breaking response-contract change and will be removed in a follow-up deprecation PR."},"flags":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Dashboard feature flags resolved for this org, keyed by flag id. Forward-looking surface for flags the dashboard gates its UI on; a new dashboard flag appears here with no response-contract change. The dedicated booleans above remain authoritative for the entitlements they name."}}},"OrgMembership":{"type":"object","required":["organizationId","name","role","features"],"properties":{"organizationId":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"features":{"$ref":"#/components/schemas/OrgFeatures"}}},"Me":{"type":"object","required":["user","organizations"],"properties":{"user":{"$ref":"#/components/schemas/UserProfile"},"organizations":{"type":"array","items":{"$ref":"#/components/schemas/OrgMembership"}}}},"Whoami":{"type":"object","required":["principalType","organizationId"],"properties":{"principalType":{"type":"string","enum":["api_key","user","platform_admin"],"description":"Whether the caller authenticated with an API key, a user session, or ADMIN_API_TOKEN."},"organizationId":{"type":"string","description":"The org this request acts in (fixed for a key, the active org for a session; may be empty for a session mid-onboarding)."},"organizationName":{"type":"string"},"userId":{"type":"string","description":"Set for a user session."},"email":{"type":"string","description":"Set for a user session."},"role":{"type":"string","description":"The user's role in the acting org (session only)."},"scopes":{"type":"array","items":{"type":"string"},"description":"The API key's scopes (key principal only)."},"availableOrgs":{"type":"array","items":{"$ref":"#/components/schemas/OrgMembership"},"description":"Every org the user belongs to (session only)."}}},"MyInvite":{"type":"object","required":["organizationId","role","invitedAt"],"properties":{"organizationId":{"type":"string"},"organizationName":{"type":"string"},"role":{"type":"string"},"inviterEmail":{"type":"string","description":"Email of the user who sent the invite, when resolvable."},"invitedAt":{"type":"string"},"expiresAt":{"type":"string"}}},"AcceptInviteResult":{"type":"object","required":["organizationId","role"],"properties":{"organizationId":{"type":"string"},"role":{"type":"string"}}},"UpdateProfileRequest":{"type":"object","properties":{"fullName":{"type":"string"},"avatarUrl":{"type":"string"},"defaultOrganizationId":{"type":"string"}}},"Organization":{"type":"object","required":["id","shortId","name","slug","billingEmail","plan"],"properties":{"id":{"type":"string"},"shortId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"billingEmail":{"type":"string"},"plan":{"type":"string"},"isProvider":{"type":"boolean"},"createdAt":{"type":"string"},"taxId":{"type":"string","description":"Customer tax identifier stored on the organization (US EIN, EU/UK VAT, SG GST, etc.), shown on the billing settings page. Requires taxCountry."},"taxCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country whose tax scheme taxId belongs to (e.g. US, GB, SG, DE)."},"accountStatus":{"type":"string","description":"User-facing account state derived from the org's trust & safety risk state. \"active\" = normal; \"restricted\" = new deploys paused pending review (existing workloads keep running, funding still allowed); \"suspended\" = read-only, workloads stopped, pending review; \"banned\" = disabled. Drives the dashboard account-status banner. Omitted/\"active\" means no banner.\n"}}},"Member":{"type":"object","required":["userId","role"],"properties":{"userId":{"type":"string"},"role":{"type":"string"},"email":{"type":"string"},"fullName":{"type":"string"},"avatarUrl":{"type":"string"},"invitedAt":{"type":"string"},"joinedAt":{"type":"string"},"status":{"type":"string","enum":["active","invited"]}}},"Invite":{"type":"object","required":["email","role","invitedAt"],"properties":{"email":{"type":"string"},"role":{"type":"string"},"invitedBy":{"type":"string"},"invitedAt":{"type":"string"},"expiresAt":{"type":"string","description":"RFC3339; the invite cannot be accepted after this time. Re-invite to refresh."}}},"CreateOrgRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"slug":{"type":"string"},"billingEmail":{"type":"string"},"deviceFingerprint":{"type":"string","maxLength":128,"description":"Optional Fingerprint visitor id (see DeviceSignals). Recorded and clustered; never gates org creation."},"deviceEventId":{"type":"string","maxLength":128,"description":"Optional Fingerprint event id (see DeviceSignals)."}}},"UpdateOrgRequest":{"type":"object","properties":{"name":{"type":"string"},"billingEmail":{"type":"string"},"taxId":{"type":"string","description":"Tax identifier to store, max 64 chars. Requires taxCountry (in this request or already on the org). Empty string clears it."},"taxCountry":{"type":"string","description":"ISO 3166-1 alpha-2 (e.g. US, GB). Empty string clears it."}}},"AddMemberRequest":{"type":"object","required":["email","role"],"properties":{"email":{"type":"string"},"role":{"type":"string","enum":["admin","member","viewer"]}}},"UpdateMemberRoleRequest":{"type":"object","required":["role"],"properties":{"role":{"type":"string","enum":["owner","admin","member","viewer"]}}},"Modalities":{"type":"object","description":"Input and output modalities the model accepts and produces. Values are free-form strings (text, image, audio, video, and novel ones such as a world model's state/actions) so new modalities need no schema change. This is what distinguishes text→text, vision (image→text), text→image, image→image, TTS/STT, and video/world models.\n","required":["input","output"],"properties":{"input":{"type":"array","items":{"type":"string"},"description":"What the model accepts, e.g. [text], [text, image]."},"output":{"type":"array","items":{"type":"string"},"description":"What the model produces, e.g. [text], [image], [video]."}}},"Model":{"type":"object","description":"A public model in the OpenRelay catalog (OpenAI-compatible).","required":["id","object","created","owned_by","supported_apis","modalities","status"],"properties":{"id":{"type":"string","description":"Public model id, send this in the `model` field of a request."},"object":{"type":"string","enum":["model"]},"created":{"type":"integer","format":"int64","description":"Unix timestamp (seconds) the model was added to the catalog."},"owned_by":{"type":"string","description":"Always \"openrelay\"."},"supported_apis":{"type":"array","items":{"type":"string"},"description":"API families this model serves, e.g. chat_completions, images, embeddings."},"modalities":{"$ref":"#/components/schemas/Modalities"},"status":{"type":"string","enum":["available","request_access"],"description":"available = usable now. request_access = listed for discovery but not yet invocable for your organization; request access to enable it.\n"},"batch_eligible":{"type":"boolean","description":"Whether this model can be run through the Batch API (POST /v1/batches). Omitted/false = online only. Batch pricing is ~50% of the online rate.\n"},"pricing":{"$ref":"#/components/schemas/ModelPricing"}}},"ModelPricing":{"type":"object","description":"Public per-1M-token price for this model in USD (the online rate; batch runs ~50% of it). Present only for a model whose price is not published elsewhere, e.g. an org-scoped endpoint the catalog serves directly to your organization. A widely-listed model omits it (its rate is documented on the pricing page).\n","properties":{"input":{"type":"number","description":"USD per 1M input tokens."},"output":{"type":"number","description":"USD per 1M output tokens."}}},"ModelList":{"type":"object","required":["object","data"],"properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/Model"}}}},"NodeClassCap":{"type":"object","required":["nodeId","freeUnits","freeGpus"],"properties":{"nodeId":{"type":"string"},"freeUnits":{"type":"integer"},"freeGpus":{"type":"integer"},"unitSizes":{"type":"array","items":{"type":"integer"},"description":"Free unit sizes on this node (for display/tiling)."},"reserved":{"type":"boolean","description":"This node's free capacity in your view is held exclusively for your organization under a node reservation."},"spot":{"type":"boolean","description":"This node carries capacity released from a reservation to the spot market: buyable at tier=spot only, and terminable without notice when the capacity owner wants it back."}}},"ClassAvailability":{"type":"object","required":["totalGpus","freeGpus","maxPlaceableGpus"],"description":"Availability for one consumption mode of a model: \"vm\" = VFIO passthrough (exact, from per-node unit state); \"cluster\" = container device-request (capacity minus cluster commitment).","properties":{"totalGpus":{"type":"integer","description":"free + claimed"},"freeGpus":{"type":"integer"},"maxPlaceableGpus":{"type":"integer","description":"Largest single allocation possible right now: for a VM the biggest tiling on any one node, for a cluster the largest per-replica device count on any one node. A workload can never exceed this even if freeGpus is larger (it lands on a single node)."},"placeableGpuCounts":{"type":"array","items":{"type":"integer"},"description":"GPU counts actually placeable on >=1 node right now. Frontends drive the count picker from this so offered counts can't 409/deploy-timeout."},"tileLattice":{"type":"array","items":{"type":"integer"},"description":"Structural set of counts this model's units can ever tile to (free or not): the hardware shape. vm view only; clusters are step-1."},"reservedFreeGpus":{"type":"integer","description":"How much of freeGpus is reserved exclusively for your organization: capacity you contracted for, as opposed to capacity you would be renting from the open market. Absent or 0 when none of it is yours."},"spotFreeGpus":{"type":"integer","description":"Free GPUs released from a node reservation to the spot market. NOT included in freeGpus, because you can only get them by asking for tier=spot, which accepts that the capacity owner may terminate the workload at any time to take the hardware back."},"spotPlaceableGpuCounts":{"type":"array","items":{"type":"integer"},"description":"GPU counts placeable right now at tier=spot (released capacity plus ordinary public capacity). A superset of placeableGpuCounts; drive a spot buyer's count picker from this."},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/NodeClassCap"}}}},"GpuAvailability":{"type":"object","required":["gpuModelId","vm","cluster"],"description":"Per-model GPU availability, answered separately for the two consumption modes because a physical GPU belongs to exactly one alloc-class (its driver binding): \"vm\" (vfio-group passthrough) and \"cluster\" (device-request).","properties":{"gpuModelId":{"type":"string"},"name":{"type":"string","description":"Catalog display name, echoed here so a client picking from availability alone (the orl interactive picker) can show something other than a UUID."},"vramGb":{"type":"integer"},"formFactor":{"type":"string","description":"Board type, see GpuModel.formFactor. Distinguishes SKUs that share a die."},"vm":{"$ref":"#/components/schemas/ClassAvailability"},"cluster":{"$ref":"#/components/schemas/ClassAvailability"}}},"GpuModel":{"type":"object","required":["id","name","manufacturer","vramGb","hidden"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"manufacturer":{"type":"string"},"vramGb":{"type":"integer"},"architecture":{"type":"string"},"formFactor":{"type":"string","description":"Board type: \"sxm\", \"pcie\", \"nvl\", \"oam\", or absent when unknown. One GPU die ships in several boards that differ in memory type, TDP and peer bandwidth, so they are separate models at separate prices. Read this instead of parsing name."},"interconnect":{"type":"string","description":"Peer fabric: \"nvlink\", \"nvswitch\", \"infinity-fabric\", or absent for PCIe-only parts. Present here so a client can tell an NVLink-capable SKU from a PCIe one without parsing name."},"hidden":{"type":"boolean"},"createdAt":{"type":"string"}}},"GpuPrice":{"type":"object","required":["gpuModelId","tier","pricePerHourCents"],"properties":{"gpuModelId":{"type":"string"},"gpuModelName":{"type":"string"},"vramGb":{"type":"integer"},"tier":{"type":"string"},"pricePerHourCents":{"type":"integer"}}},"CpuPrice":{"type":"object","required":["resourceSize","pricePerHourCents","vcpu","ramMb"],"properties":{"resourceSize":{"type":"string"},"pricePerHourCents":{"type":"integer"},"vcpu":{"type":"integer","description":"vCPU cores a machine of this size boots with"},"ramMb":{"type":"integer","description":"guest RAM in MiB a machine of this size boots with"}}},"VmDiskLimits":{"type":"object","required":["minGb","maxGb"],"description":"Live VM boot-disk size bounds the control plane accepts. Runtime env-tunable, so clients read these instead of hardcoding a ceiling that would drift from the server. A request outside the range is a 400.\n","properties":{"minGb":{"type":"integer","description":"smallest boot disk a VM may request"},"maxGb":{"type":"integer","description":"largest boot disk a VM may request"}}},"Pricing":{"type":"object","required":["gpu","cpu","vmDisk"],"properties":{"gpu":{"type":"array","items":{"$ref":"#/components/schemas/GpuPrice"}},"cpu":{"type":"array","items":{"$ref":"#/components/schemas/CpuPrice"}},"vmDisk":{"$ref":"#/components/schemas/VmDiskLimits"}}},"VmTemplate":{"type":"object","required":["id","name","slug","filename","requiresGpu","osType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"},"filename":{"type":"string"},"requiresGpu":{"type":"boolean"},"osVersion":{"type":"string"},"driverVersion":{"type":"string"},"osType":{"type":"string"},"isDefault":{"type":"boolean"},"sortOrder":{"type":"integer"},"compatibleGpuModelIds":{"type":"array","nullable":true,"items":{"type":"string"},"description":"GPU model ids this template supports; null = all GPUs allowed"}}},"Location":{"type":"object","required":["id","name","city","country","region"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"region":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"}}},"ClusterSummary":{"type":"object","required":["id","organizationId","name","status"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"gpuModelId":{"type":"string"},"replicaCount":{"type":"integer"},"activeReplicas":{"type":"integer"},"endpointUrl":{"type":"string"},"createdAt":{"type":"string"}}},"ClusterPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ClusterSummary"}},"nextCursor":{"type":"string"}}},"ClusterReplicaItem":{"type":"object","required":["id","gpuCount","status","healthy","nvlinkEnabled","createdAt"],"properties":{"id":{"type":"string"},"nodeId":{"type":"string"},"gpuCount":{"type":"integer"},"status":{"type":"string"},"healthy":{"type":"boolean"},"lastHealthCheckAt":{"type":"string"},"consecutiveFailures":{"type":"integer"},"internalIp":{"type":"string"},"port":{"type":"integer"},"endpointUrl":{"type":"string"},"sshPort":{"type":"integer"},"startedAt":{"type":"string"},"createdAt":{"type":"string"},"diskUsedBytes":{"type":"integer","format":"int64"},"diskTotalBytes":{"type":"integer","format":"int64"},"diskUpdatedAt":{"type":"string"},"nvlinkEnabled":{"type":"boolean"},"nodeHostname":{"type":"string"},"nodeLocation":{"type":"string"},"nodeRegion":{"type":"string"}}},"ClusterDetail":{"type":"object","required":["id","organizationId","name","status","gpusPerReplica","resourceSize","replicaCount","tier","allowFallback","diskSizeGb","privileged","replicas","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"statusReason":{"type":"string","description":"human-readable cause for failed/stuck states"},"gpuModelId":{"type":"string"},"gpusPerReplica":{"type":"integer"},"resourceSize":{"type":"string"},"replicaCount":{"type":"integer"},"tier":{"type":"string"},"preferredRegions":{"type":"array","items":{"type":"string"}},"allowFallback":{"type":"boolean"},"imageUrl":{"type":"string"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"containerPort":{"type":"integer"},"healthChecks":{"type":"array","items":{"type":"string"}},"healthCheckPath":{"type":"string"},"healthCheckPort":{"type":"integer"},"diskSizeGb":{"type":"integer"},"privileged":{"type":"boolean"},"notes":{"type":"string"},"endpointUrl":{"type":"string"},"deployToken":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"gpuModel":{"$ref":"#/components/schemas/GpuModel"},"replicas":{"type":"array","items":{"$ref":"#/components/schemas/ClusterReplicaItem"}}}},"CreateClusterRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"resourceSize":{"type":"string"},"tier":{"type":"string"},"replicaCount":{"type":"integer"},"gpuModelId":{"type":"string"},"gpusPerReplica":{"type":"integer"},"imageUrl":{"type":"string"},"containerPort":{"type":"integer"},"preferredRegions":{"type":"array","items":{"type":"string"}},"allowFallback":{"type":"boolean"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"registryCredentialId":{"type":"string"},"healthChecks":{"type":"array","items":{"type":"string"}},"healthCheckPath":{"type":"string"},"healthCheckPort":{"type":"integer"},"diskSizeGb":{"type":"integer"},"containerCommand":{"type":"array","items":{"type":"string"}},"privileged":{"type":"boolean"},"kernelModules":{"type":"array","items":{"type":"string"}},"templateId":{"type":"string"}}},"ScaleRequest":{"type":"object","required":["replicaCount"],"properties":{"replicaCount":{"type":"integer","minimum":1}}},"VmSummary":{"type":"object","required":["id","organizationId","name","status"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","description":"deploying, running, stopped, failed, terminated; a pod can also be interrupted: it served, is not serving now (its node is offline or its supervisor died), keeps its node, GPU and /workspace volume, is not billed, and resumes on its own. A pod interrupted for 7 days is deleted."},"statusReason":{"type":"string","description":"Cause of the current status. The machine-readable values are \"node_lost\" (the host went offline and is expected back, so the disk is preserved), \"node_removed\" (the host was decommissioned, so the disk is gone and a restart deploys fresh elsewhere), \"vm_exited\", \"user_stopped\", \"user_terminated\", \"user_restarted\", \"spot_reclaimed_by_capacity_owner\", \"spot_preempted_for_reservation_tenant\", \"auto_stopped_insufficient_balance\", and the prefix \"container failed to start: \" followed by the container runtime's own message. Anything else is free text for a human to read."},"gpuModelId":{"type":"string"},"gpuCount":{"type":"integer"},"endpointUrl":{"type":"string"},"volumeGb":{"type":"integer","description":"pods only: size in GB of the pod's persistent /workspace volume."},"public":{"type":"boolean","description":"true = open endpoint (no data-plane auth); false = require an org API key"},"createdAt":{"type":"string"},"provisioningStage":{"type":"string"},"resourceSize":{"type":"string"},"tier":{"type":"string"},"diskSizeGb":{"type":"integer"},"gpuModelName":{"type":"string"},"pricePerHourCents":{"type":"integer"},"serviceType":{"type":"string","description":"managed-service tag; empty for a plain VM"},"managedBy":{"type":"string","description":"platform owner of this row (\"serving\" = inference serving replica, read-only on customer surfaces); empty for a customer-launched VM"},"capabilityTier":{"type":"string","description":"compute-fabric capability tier (e.g. \"pod\"); empty for a plain VM"},"computeClass":{"type":"string","description":"compute-fabric purchase option (on_demand; pods created before the rename carry the legacy reserved or interruptible values); empty for a plain VM"},"imageUrl":{"type":"string","description":"tenant container image (pods)"}}},"VmPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/VmSummary"}},"nextCursor":{"type":"string"}}},"VmGpuInfo":{"type":"object","required":["name","vramGb"],"properties":{"name":{"type":"string"},"vramGb":{"type":"integer"},"pricePerHourCents":{"type":"integer","description":"current catalog per-GPU-hour rate for this model/tier (informational; the billed rate is VmDetail.pricePerHourCents)"}}},"VmNodeInfo":{"type":"object","required":["hostname"],"properties":{"hostname":{"type":"string"},"location":{"type":"string"}}},"VmTemplateInfo":{"type":"object","required":["name","osType"],"properties":{"name":{"type":"string"},"osType":{"type":"string"},"osVersion":{"type":"string"}}},"VmDetail":{"type":"object","required":["id","organizationId","name","status","gpuCount","resourceSize","tier","diskSizeGb","healthy","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"statusReason":{"type":"string","description":"Cause of the current status; see VmSummary.statusReason for the machine-readable values."},"provisioningStage":{"type":"string"},"gpuModelId":{"type":"string"},"gpuCount":{"type":"integer"},"resourceSize":{"type":"string"},"tier":{"type":"string"},"diskSizeGb":{"type":"integer"},"diskUsedBytes":{"type":"integer","format":"int64"},"diskTotalBytes":{"type":"integer","format":"int64"},"imageUrl":{"type":"string"},"capabilityTier":{"type":"string","description":"compute-fabric capability tier (e.g. \"pod\"); empty for a plain VM"},"computeClass":{"type":"string","description":"compute-fabric purchase option (on_demand; pods created before the rename carry the legacy reserved or interruptible values); empty for a plain VM"},"containerPort":{"type":"integer"},"endpointUrl":{"type":"string"},"public":{"type":"boolean","description":"true = open endpoint (no data-plane auth); false = require an org API key"},"healthy":{"type":"boolean"},"nodeId":{"type":"string"},"internalIp":{"type":"string"},"sshPort":{"type":"integer"},"rdpPort":{"type":"integer"},"rdpPassword":{"type":"string"},"persistentDiskPath":{"type":"string"},"startedAt":{"type":"string"},"terminatedAt":{"type":"string","description":"RFC3339 time the VM was terminated. Set only once status is \"terminated\" (a stopped/failed VM can restart, so it has none); absent while the VM is live. On a terminated VM, healthy is false and provisioningStage is absent."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"osType":{"type":"string"},"nonBillable":{"type":"boolean","description":"This VM's usage is recorded but never charged: a provider org consuming GPUs on a node it owns under its own reservation. pricePerHourCents still reports the real rate (the measurement is kept, the charge is waived) so a client showing a rate MUST also show this or it will display a bill that never arrives."},"pricePerHourCents":{"type":"integer","description":"bundled hourly rate. When the VM has an open usage session this is the rate LOCKED at session open (what settlement charges); otherwise the rate a session WOULD lock: the fabric admission snapshot for a pod, else the current catalog rate for the VM's shape."},"sshHost":{"type":"string","description":"data-plane SSH gateway host, e.g. ssh.run.beta.openrelay.inc"},"sshHandle":{"type":"string","description":"RunPod-style SSH handle (first label of endpointUrl); used as the SSH username"},"sshUser":{"type":"string","description":"login user the gateway lands as inside the VM (e.g. ubuntu)"},"sshCommand":{"type":"string","description":"ready-to-paste ssh command (ssh @)"},"sshReady":{"type":"boolean","description":"true when SSH should work now. Observed: a node-side probe saw the guest sshd answer. Falls back to the running-status guess on nodes not yet reporting probes (sshState=unverified)."},"sshState":{"type":"string","enum":["ready","booting","unverified","offline"],"description":"why sshReady is what it is. booting = the VM is running but its guest OS has not started sshd yet (GPU VMs take minutes); unverified = no probe signal for this node, sshReady is a guess; offline = the VM is not running."},"sshStateReason":{"type":"string","description":"human-readable explanation of sshState, safe to show to the customer"},"serviceType":{"type":"string","description":"managed-service tag; empty for a plain VM"},"hostDiskFreeGb":{"type":"integer","description":"pods only: free disk on the pod's host node, shared across the pods on that node. Pods have no per-pod quota, and pod storage does not persist across terminate. Absent when the node reports no live disk signal."},"hostDiskTotalGb":{"type":"integer","description":"pods only: total disk on the pod's host node, shared across the pods on that node. Pods have no per-pod quota, and pod storage does not persist across terminate. Absent when the node reports no live disk signal."},"volumeGb":{"type":"integer","description":"pods only: size in GB of the pod's persistent volume at volumeMountPath. Absent on a pod created before volumes existed."},"volumeMountPath":{"type":"string","description":"pods only: where the persistent volume is mounted inside the container (/workspace)."},"volumeUsedBytes":{"type":"integer","format":"int64","description":"pods only: bytes the volume currently holds, as of volumeUsedAt (the node reports daily). Absent until the node has reported."},"volumeUsedAt":{"type":"string","description":"pods only: RFC3339 time of the volumeUsedBytes report."},"interruptedAt":{"type":"string","description":"pods only: RFC3339 time the pod became interrupted; present only while status is interrupted. The pod is deleted 7 days after it."},"gpuInfo":{"$ref":"#/components/schemas/VmGpuInfo"},"nodeInfo":{"$ref":"#/components/schemas/VmNodeInfo"},"templateInfo":{"$ref":"#/components/schemas/VmTemplateInfo"}}},"VmBurn":{"type":"object","required":["vmId","pricePerHourCents","rateSource","rateBasis","diskBilled","orgAccruedCents","orgAccruedMonthCents","orgAvailableCents","orgBurnPerHourCents","projectedRunwayHours","autoStopFloorCents"],"properties":{"vmId":{"type":"string"},"pricePerHourCents":{"type":"integer","description":"the VM's bundled hourly rate: the open usage record's locked rate when a session is accruing, else the current catalog rate for the VM's shape"},"nonBillable":{"type":"boolean","description":"This VM's usage is recorded but never charged (a provider consuming its own reserved node), so pricePerHourCents is informational and every cents figure below is 0 for it. Without this a client cannot tell \"not charged\" from \"nothing running\"."},"rateSource":{"type":"string","enum":["locked","catalog"],"description":"locked = read from the open usage record (exactly what settlement will charge); catalog = no open session, the rate that would apply on next start"},"rateBasis":{"type":"string","enum":["gpu","cpu"],"description":"gpu = per-GPU catalog price times gpuCount; cpu = flat per-resource-size rate"},"gpuCount":{"type":"integer","description":"set when rateBasis is gpu"},"perGpuCents":{"type":"integer","description":"pricePerHourCents / gpuCount; set when rateBasis is gpu"},"diskBilled":{"type":"boolean","description":"always false today: disk is included in the bundled hourly rate and never billed as a separate line item"},"accruedSessionCents":{"type":"integer","description":"cost accrued by the open session so far (session span times the locked rate, the same span math settlement uses); omitted when no session is open"},"sessionStartedAt":{"type":"string","description":"start of the open usage session; omitted when none"},"orgAccruedCents":{"type":"integer","description":"the org's un-settled usage across all workloads: the current month, plus any prior month not yet settled"},"orgAccruedMonthCents":{"type":"integer","deprecated":true,"description":"deprecated alias of orgAccruedCents (same value; the name predates un-settled prior months being included); will be removed in a future spec version"},"orgAvailableCents":{"type":"integer","description":"spendable balance = ledger balance minus orgAccruedCents (can be negative)"},"orgBurnPerHourCents":{"type":"integer","description":"sum of the locked rates of every open usage record in the org"},"projectedRunwayHours":{"type":"number","format":"double","nullable":true,"description":"(orgAvailableCents - autoStopFloorCents) / orgBurnPerHourCents; null when orgBurnPerHourCents is 0, clamped to 0 when available is already at or below the floor"},"autoStopFloorCents":{"type":"integer","description":"available-balance floor (cents) below which the org is auto-stopped"}}},"CreateVmRequest":{"type":"object","required":["name","sshKeyIds"],"properties":{"name":{"type":"string"},"resourceSize":{"type":"string"},"tier":{"type":"string"},"gpuModelId":{"type":"string"},"gpuCount":{"type":"integer"},"imageUrl":{"type":"string"},"containerPort":{"type":"integer"},"preferredRegions":{"type":"array","items":{"type":"string"}},"allowFallback":{"type":"boolean"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"registryCredentialId":{"type":"string"},"healthChecks":{"type":"array","items":{"type":"string"}},"healthCheckPath":{"type":"string"},"healthCheckPort":{"type":"integer"},"diskSizeGb":{"type":"integer"},"containerCommand":{"type":"array","items":{"type":"string"}},"privileged":{"type":"boolean"},"kernelModules":{"type":"array","items":{"type":"string"}},"templateId":{"type":"string"},"sshKeyIds":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string"},"description":"Org SSH key ids injected into the guest. At least one is required and every id must name a live key of this org: the data-plane gateway authorizes guest SSH against exactly this list, so a VM created without one has no SSH access."},"public":{"type":"boolean","description":"true = open endpoint (no data-plane auth); default false requires an org API key"},"cloudInit":{"type":"string","maxLength":16384,"description":"Startup script run inside the guest the first time this VM boots. Must begin with a shebang (e.g. \"#!/bin/bash\"); a raw cloud-config document is rejected. Runs once per disk, not once per boot: a stop/start keeps the disk and does not re-run it, while a VM that lands on a fresh disk does. It runs as root once the network and your SSH keys are up, and its output goes to the VM's logs. A script that fails does not stop the VM from starting or from being billed, so check the logs rather than assuming it succeeded."},"nodeId":{"type":"string","description":"Place this VM on a specific node. Required to use capacity reserved to your org; omit to use the public pool. There is no fallback: if the node has no room for this GPU count the request is refused rather than placed elsewhere. A node you have no rights on reads as not found."}}},"VmSshKeyItem":{"type":"object","required":["id","name","fingerprint","attached","crossOrg"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fingerprint":{"type":"string"},"attached":{"type":"boolean"},"crossOrg":{"type":"boolean"},"orgName":{"type":"string","nullable":true}}},"AttachSshKeyRequest":{"type":"object","required":["sshKeyId"],"properties":{"sshKeyId":{"type":"string"}}},"ResizeDiskRequest":{"type":"object","required":["newSizeGb"],"properties":{"newSizeGb":{"type":"integer"}}},"SetVmVisibilityRequest":{"type":"object","required":["public"],"properties":{"public":{"type":"boolean","description":"true = open endpoint (no data-plane auth); false = require an org API key"}}},"TelegramLinkResult":{"type":"object","required":["present"],"properties":{"present":{"type":"boolean"},"telegramUserId":{"type":"integer","format":"int64"},"telegramUsername":{"type":"string"},"linkingCode":{"type":"string"},"linkedAt":{"type":"string"},"createdAt":{"type":"string"}}},"VmMetrics":{"type":"object","required":["vmId","range","start","end","stepSeconds","pointCount","accelerator","gpus"],"properties":{"vmId":{"type":"string"},"range":{"type":"string","enum":["1h","6h","24h","7d"],"x-enum-varnames":["VmMetricsRangeN1h","VmMetricsRangeN6h","VmMetricsRangeN24h","VmMetricsRangeN7d"],"description":"the requested window length; the window always ends at the moment the request was served"},"start":{"type":"string","format":"date-time","description":"first point of the returned grid, after the requested range was clipped to the periods this pod actually held GPUs on its current node. Equal to end when nothing was queried."},"end":{"type":"string","format":"date-time","description":"last point of the returned grid. It is the newest grid point at or before the moment the request was served, so it can be up to one step older than that moment."},"stepSeconds":{"type":"integer","description":"seconds between grid points: 60 for a 1h range, 300 for 6h, 900 for 24h, 3600 for 7d"},"pointCount":{"type":"integer","description":"length of the values array of every series in this response. 0 when nothing was queried, in which case start equals end."},"accelerator":{"$ref":"#/components/schemas/AcceleratorCapability"},"gpus":{"type":"array","description":"one entry per GPU this pod holds or held during the returned window, in the order the pod claimed them. Empty whenever the response carries no series at all, which is every unavailable status and the source_unreachable one.","items":{"$ref":"#/components/schemas/VmGpuMetrics"}}}},"AcceleratorCapability":{"type":"object","description":"whether accelerator telemetry could be read at all, and why not when it could not. The status is the answer: an unreadable accelerator is still a 200.","required":["class","status"],"properties":{"class":{"type":"string","enum":["accelerator"],"x-enum-varnames":["AcceleratorCapabilityClassAccelerator"]},"status":{"type":"string","enum":["available","degraded","unavailable"],"x-enum-varnames":["AcceleratorCapabilityStatusAvailable","AcceleratorCapabilityStatusDegraded","AcceleratorCapabilityStatusUnavailable"],"description":"available = the GPUs were readable; degraded = the metrics store could not be read, or the host stopped reporting while the pod is still running; unavailable = there is nothing to read for this pod."},"source":{"type":"string","enum":["nvidia-smi"],"x-enum-varnames":["AcceleratorCapabilitySourceNvidiaSmi"],"description":"how the numbers were measured; present whenever the response carries series"},"reason":{"type":"string","enum":["accelerator_passthrough","guest_not_started","no_session_in_range","no_gpus_recorded","source_unreachable","source_stale"],"x-enum-varnames":["AcceleratorCapabilityReasonAcceleratorPassthrough","AcceleratorCapabilityReasonGuestNotStarted","AcceleratorCapabilityReasonNoSessionInRange","AcceleratorCapabilityReasonNoGpusRecorded","AcceleratorCapabilityReasonSourceUnreachable","AcceleratorCapabilityReasonSourceStale"],"description":"machine-readable cause when status is not available. Absent when the cause has no code of its own, in which case detail carries it."},"detail":{"type":"string","description":"one sentence explaining the status, safe to show a customer as-is"}}},"VmGpuMetrics":{"type":"object","required":["bdf","busySeconds","series"],"properties":{"bdf":{"type":"string","description":"the GPU's PCI address on its host, lowercase with a four-digit domain (for example 0000:04:00.0)"},"busySeconds":{"type":"number","format":"double","description":"estimated GPU-busy time over the returned window, integrated from the node's utilization samples. Counted from the first sample inside the window, so up to one step of busy time at the window start is not included. 0 when the node reported nothing."},"series":{"type":"array","items":{"$ref":"#/components/schemas/VmGpuSeries"}}}},"VmGpuSeries":{"type":"object","required":["key","unit","values"],"properties":{"key":{"type":"string","enum":["utilization_ratio","memory_used_bytes","memory_total_bytes","power_watts","temperature_celsius"],"x-enum-varnames":["VmGpuSeriesKeyUtilizationRatio","VmGpuSeriesKeyMemoryUsedBytes","VmGpuSeriesKeyMemoryTotalBytes","VmGpuSeriesKeyPowerWatts","VmGpuSeriesKeyTemperatureCelsius"]},"unit":{"type":"string","enum":["ratio","bytes","watts","celsius"],"x-enum-varnames":["VmGpuSeriesUnitRatio","VmGpuSeriesUnitBytes","VmGpuSeriesUnitWatts","VmGpuSeriesUnitCelsius"]},"values":{"type":"array","x-go-type":"[]*float64","description":"one value per grid point, oldest first: the value at index i was measured at start plus i times stepSeconds. The array is pointCount long in every series and every GPU of one response, so a client reads the grid index-parallel and never needs the timestamps. null where the node reported no sample; a gap is never filled with 0.","items":{"type":"number","format":"double","nullable":true}}}},"CreatePodRequest":{"type":"object","required":["image"],"description":"Request to create a compute-fabric pod: a RunPod-style bring-your-own container image + SSH keys guest. A focused subset of CreateVmRequest (no qcow2 template / kernel modules / privileged mode).","properties":{"name":{"type":"string"},"gpuModelId":{"type":"string"},"computeClass":{"type":"string","enum":["on_demand","reserved","interruptible"],"default":"on_demand","description":"purchase option. on_demand (pay per second, no commitment) is the only class sold; reserved is a deprecated alias that is stored as on_demand. interruptible is retired and rejected with 400 COMPUTE_CLASS_RETIRED; it remains listed only until the deprecation window closes."},"image":{"type":"string","description":"tenant container image ref (required)"},"gpuCount":{"type":"integer","default":1,"minimum":1,"maximum":8,"description":"how many whole GPUs this pod gets. All of them are claimed on ONE node and passed to the container together; the pod is priced for gpuCount GPUs. Omitted = 1. A request larger than any single node can currently tile is rejected at admission (see freeUnits / maxGpuCount on /v1/pods/capacity)."},"sshKeys":{"type":"array","items":{"type":"string"},"description":"tenant SSH public keys injected into the guest"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"httpPort":{"type":"integer","default":80,"description":"in-guest HTTP port exposed on the endpoint"},"shmSizeGb":{"type":"integer","minimum":1,"maximum":8192,"description":"size of the pod's private /dev/shm in GiB (docker --shm-size). Optional; the maximum is half the pod's memory limit on its placement node (itself the pod's GPU-proportional share of node RAM), and a larger value is rejected at admission. Omitted lets the platform pick a safe default: that same maximum for a pod that owns its whole node, 2 GiB per GPU (capped at the maximum) for a shared multi-GPU pod, and docker's default for a shared single-GPU pod. Raise this when a multi-GPU NCCL / PyTorch DataLoader workload needs more shared memory than the default."},"public":{"type":"boolean","default":false,"description":"true = open endpoint (no data-plane auth); default false requires an org API key"},"volumeGb":{"type":"integer","minimum":10,"maximum":1024,"description":"size in GB of the pod's persistent volume, mounted read-write at /workspace. Omitted = 50. The volume lives on the pod's node and is kept across stop, start, restart, container crashes, node reboots and interruptions; it is deleted only when the pod is deleted (or after 7 days interrupted with its node gone). Everything outside /workspace is the container's own filesystem and is reset whenever the container is recreated. Fixed at create; there is no resize."}}},"PodCapacityItem":{"type":"object","required":["gpuModelId","name","vramGb","freeUnits","totalUnits","maxGpuCount","rateOnDemandCentsPerHour","rateReservedCentsPerHour","rateInterruptibleCentsPerHour"],"description":"Live pod capacity for one GPU model. freeUnits counts what a create can claim RIGHT NOW (free device-request units on online, non-delisted nodes); rateOnDemandCentsPerHour is the server-computed price so clients never re-derive pricing.","properties":{"gpuModelId":{"type":"string"},"name":{"type":"string"},"vramGb":{"type":"integer"},"freeUnits":{"type":"integer","description":"GPU units claimable right now (each pod takes one whole GPU)"},"totalUnits":{"type":"integer","description":"all pod units on online nodes, including ones currently claimed"},"maxGpuCount":{"type":"integer","description":"largest gpuCount a single create can be granted right now: the biggest exact per-node tiling of free placeable units (0 = nothing claimable)"},"rateOnDemandCentsPerHour":{"type":"integer","description":"on-demand rate, cents per GPU-hour: what a create is charged"},"rateReservedCentsPerHour":{"type":"integer","deprecated":true,"description":"deprecated alias of rateOnDemandCentsPerHour, carrying the same value"},"rateInterruptibleCentsPerHour":{"type":"integer","deprecated":true,"description":"deprecated: the interruptible class is retired, so this equals rateOnDemandCentsPerHour"}}},"Snapshot":{"type":"object","required":["id","organizationId","name","status","diskSizeGb","chainDepth","createdAt"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"sourceVmId":{"type":"string"},"nodeId":{"type":"string"},"name":{"type":"string"},"diskPath":{"type":"string"},"diskSizeGb":{"type":"integer"},"sizeBytes":{"type":"integer","format":"int64"},"chainDepth":{"type":"integer"},"templateId":{"type":"string"},"gpuModelId":{"type":"string"},"gpuCount":{"type":"integer"},"resourceSize":{"type":"string"},"imageUrl":{"type":"string"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"containerPort":{"type":"integer"},"status":{"type":"string"},"errorMessage":{"type":"string"},"createdAt":{"type":"string"},"deletedAt":{"type":"string"}}},"CreateSnapshotRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},"ForkRequest":{"type":"object","required":["snapshotId"],"properties":{"snapshotId":{"type":"string"},"name":{"type":"string"},"gpuModelId":{"type":"string"},"gpuCount":{"type":"integer"},"resourceSize":{"type":"string"},"diskSizeGb":{"type":"integer"},"imageUrl":{"type":"string"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"containerPort":{"type":"integer"},"sshKeyIds":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string"},"description":"Org SSH key ids for the fork. Omit to carry the source VM's keys over. Every resulting id must name a live key of this org, so forking a source whose keys are gone requires naming a replacement set here."}}},"ApiKeySummary":{"type":"object","required":["id","name","keyPrefix","scopes","createdAt"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"keyPrefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"lastUsedAt":{"type":"string"},"expiresAt":{"type":"string"},"revokedAt":{"type":"string"},"createdAt":{"type":"string"}}},"CreateApiKeyRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"scopes":{"type":"array","description":"Supported values: clusters:read, clusters:write, vms:read, vms:write, inference.","items":{"type":"string"}},"expiresInSeconds":{"type":"integer","format":"int64","description":"Optional server-side expiry, in seconds from now. When set (and > 0) the key stops authenticating after this many seconds, capping the leak window regardless of any client-side cleanup. Omitted or <= 0 means the key never expires (the default)."}}},"CreateApiKeyResult":{"type":"object","required":["id","key","keyPrefix","name","scopes","createdAt","organizationId"],"properties":{"id":{"type":"string"},"key":{"type":"string","description":"Plaintext key, shown once"},"keyPrefix":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"organizationId":{"type":"string","description":"The organization this key is bound to. Every API key belongs to exactly one organization; keep this id alongside the key so callers can build org-scoped request paths without a separate lookup (GET /v1/whoami returns the same id for an existing key)."}}},"SshKeySummary":{"type":"object","required":["id","name","publicKey","fingerprint","createdAt"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"publicKey":{"type":"string"},"fingerprint":{"type":"string"},"createdAt":{"type":"string"},"attachedVmCount":{"type":"integer","description":"Number of live (non-terminated) VMs this key is attached to. Zero means the key is not scoped to any VM. The dashboard shows an \"in use\" indicator and warns before deleting a key that is in use."},"blockingVms":{"type":"array","items":{"type":"string"},"description":"Names of VMs for which this is the only key that still resolves to a live org key. Deleting the key is refused (409) while this is non-empty; attach another key to those VMs first."}}},"CreateSshKeyRequest":{"type":"object","required":["name","publicKey"],"properties":{"name":{"type":"string"},"publicKey":{"type":"string"}}},"RegistryCredentialSummary":{"type":"object","required":["id","name","server","authType","createdAt"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"server":{"type":"string"},"authType":{"type":"string"},"createdAt":{"type":"string"}}},"CreateRegistryCredentialRequest":{"type":"object","required":["name","server","authType","credentials"],"properties":{"name":{"type":"string"},"server":{"type":"string"},"authType":{"type":"string","enum":["basic","aws_ecr","gcp_gcr"]},"credentials":{"type":"object","additionalProperties":{"type":"string"}}}},"WebhookSummary":{"type":"object","required":["id","name","url","secretPrefix","events","enabled","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"secretPrefix":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}}},"WebhookWithSecret":{"type":"object","required":["id","name","url","secretPrefix","events","enabled","createdAt","secret"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"secretPrefix":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"createdAt":{"type":"string"},"secret":{"type":"string"}}},"WebhookSecret":{"type":"object","required":["id","secret","secretPrefix"],"properties":{"id":{"type":"string"},"secret":{"type":"string"},"secretPrefix":{"type":"string"}}},"WebhookToggleResult":{"type":"object","required":["id","enabled"],"properties":{"id":{"type":"string"},"enabled":{"type":"boolean"}}},"WebhookUpdateResult":{"type":"object","required":["id","name","url","events"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}}}},"WebhookDeliveryItem":{"type":"object","required":["id","eventType","eventId","attemptNumber","status","createdAt"],"properties":{"id":{"type":"string"},"eventType":{"type":"string"},"eventId":{"type":"string"},"attemptNumber":{"type":"integer"},"status":{"type":"string"},"statusCode":{"type":"integer"},"errorMessage":{"type":"string"},"createdAt":{"type":"string"},"deliveredAt":{"type":"string"}}},"CreateWebhookRequest":{"type":"object","required":["name","url"],"properties":{"name":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}}}},"UpdateWebhookRequest":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}}}},"ToggleWebhookRequest":{"type":"object","required":["enabled"],"properties":{"enabled":{"type":"boolean"}}},"Balance":{"type":"object","required":["balanceCents","availableCents","accruedUsageCents","currentMonthUsageCents","transactions"],"properties":{"balanceCents":{"type":"integer","description":"Raw ledger balance (deposits + credits − settled debits)."},"availableCents":{"type":"integer","description":"Spendable balance = balanceCents − accruedUsageCents. This is what the deploy gate checks; it can be below balanceCents while usage is running, and slightly negative between auto-recharge ticks."},"accruedUsageCents":{"type":"integer","description":"Usage cost not yet settled into a transaction: the current month, plus any recently ended month whose settlement debit has not been written yet (briefly higher than currentMonthUsageCents right after a month rollover)."},"currentMonthUsageCents":{"type":"integer","description":"Usage cost accrued in the current calendar month only. Use this for \"spend this month\" displays; use accruedUsageCents for balance math."},"monthlySpendLimitCents":{"type":"integer","nullable":true,"description":"The org's monthly spend cap, or null if no limit is set. Drives the \"used of limit\" budget gauge in the dashboard."},"minDepositCents":{"type":"integer","description":"Smallest deposit the org can make right now, in cents: the flat $10 floor, raised to the 3-day-runway requirement while the org has open usage burning, clamped to the org's per-deposit cap. This is the exact minimum the deposit endpoint enforces (INSUFFICIENT_RUNWAY on a lower amount), so clients should render it rather than re-derive it."},"transactions":{"type":"array","items":{"$ref":"#/components/schemas/Transaction"}}}},"Transaction":{"type":"object","required":["id","type","source","amountCents","createdAt"],"properties":{"id":{"type":"string"},"type":{"type":"string"},"source":{"type":"string"},"amountCents":{"type":"integer"},"description":{"type":"string"},"inferenceDetails":{"$ref":"#/components/schemas/InferenceTransactionDetails"},"createdAt":{"type":"string"}}},"InferenceModelUsage":{"type":"object","required":["model","requestCount","batch","dimensions"],"properties":{"model":{"type":"string"},"requestCount":{"type":"string","pattern":"^[0-9]+$","description":"Exact decimal count; encoded as a string so browser clients do not lose int64 precision."},"batch":{"type":"boolean"},"dimensions":{"type":"object","description":"Exact decimal token quantities. Current keys are input, cached_input, cache_write, and output; the map shape reserves room for future metered units.","additionalProperties":{"type":"string","pattern":"^[0-9]+$"}}}},"InferenceTransactionDetails":{"type":"object","required":["models","partial","carriedNanoUSD"],"properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/InferenceModelUsage"}},"partial":{"type":"boolean","description":"True when some of the debit is not itemized in this row, including legacy usage or sub-cent cost carried from a prior row."},"carriedNanoUSD":{"type":"string","pattern":"^[0-9]+$","description":"Customer charge represented by these metered requests that remains as sub-cent accrual for a later debit."}}},"SetupIntent":{"type":"object","required":["clientSecret","publishableKey"],"properties":{"clientSecret":{"type":"string"},"publishableKey":{"type":"string"}}},"DepositRequest":{"type":"object","required":["amountCents"],"properties":{"amountCents":{"type":"integer","description":"Amount to charge the saved card, in cents (bounds $10-$500)."},"idempotencyKey":{"type":"string","description":"Client-generated id for this logical deposit; reused verbatim on retry so a network/client retry can't double-charge. Optional: the server generates one if absent (then retries won't dedupe)."},"deviceFingerprint":{"type":"string","maxLength":128,"description":"Optional Fingerprint visitor id (see DeviceSignals). Recorded and clustered; never gates the deposit."},"deviceEventId":{"type":"string","maxLength":128,"description":"Optional Fingerprint event id (see DeviceSignals)."},"captchaScore":{"type":"number","minimum":0,"maximum":1,"description":"Optional reCAPTCHA v3 score, 0 to 1 (see DeviceSignals). Recorded on the org and copied onto the dispute-evidence record; it never gates the deposit."},"captchaBand":{"type":"string","maxLength":32,"description":"Optional score band, pass|step_up|step_up_strict (see DeviceSignals). The band's step-up was already satisfied at the dashboard before this request was sent."},"captchaAction":{"type":"string","maxLength":64,"description":"Optional reCAPTCHA action the score was measured for (see DeviceSignals)."}}},"DepositResult":{"type":"object","required":["paymentIntentId","status"],"properties":{"paymentIntentId":{"type":"string"},"status":{"type":"string","description":"Stripe PaymentIntent status. \"succeeded\" → credit lands via webhook; \"requires_action\" → complete SCA on-session with clientSecret; \"requires_payment_method\" → the card was declined."},"clientSecret":{"type":"string","description":"Set only when status is requires_action (on-session SCA)."}}},"AutoRechargeSettings":{"type":"object","required":["enabled","thresholdCents","amountCents"],"properties":{"enabled":{"type":"boolean","description":"When on, the balance is topped up automatically below the threshold."},"thresholdCents":{"type":"integer","description":"Recharge fires when available balance drops below this."},"amountCents":{"type":"integer","description":"Amount charged per auto-recharge (within deposit bounds $10-$500)."}}},"PaymentMethodCard":{"type":"object","required":["id","brand","last4","expMonth","expYear"],"properties":{"id":{"type":"string"},"brand":{"type":"string"},"last4":{"type":"string"},"expMonth":{"type":"integer"},"expYear":{"type":"integer"}}},"PaymentMethods":{"type":"object","required":["paymentMethods"],"properties":{"paymentMethods":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethodCard"}},"defaultPaymentMethodId":{"type":"string"}}},"UsageBreakdownItem":{"type":"object","required":["key","hours","cents"],"properties":{"key":{"type":"string"},"hours":{"type":"number"},"cents":{"type":"integer"}}},"CurrentUsage":{"type":"object","required":["usageCents","usageHours","breakdown"],"properties":{"usageCents":{"type":"integer"},"usageHours":{"type":"number"},"breakdown":{"type":"array","items":{"$ref":"#/components/schemas/UsageBreakdownItem"}},"burnPerHourCents":{"type":"integer","description":"sum of the locked rates of every open usage record in the org (live burn per hour)"},"projectedRunwayHours":{"type":"number","format":"double","nullable":true,"description":"hours until available balance hits the auto-stop floor at the current burn: (available - autoStopFloorCents) / burnPerHourCents; null when burn is 0, clamped to 0 when already at or below the floor"},"autoStopFloorCents":{"type":"integer","description":"available-balance floor (cents) below which the org is auto-stopped"}}},"UsageSegment":{"type":"object","required":["key","cents"],"properties":{"key":{"type":"string","description":"display segment: a GPU model name, \"CPU\", or \"Inference\""},"cents":{"type":"integer"}}},"DailyUsagePoint":{"type":"object","required":["date","cents","segments"],"properties":{"date":{"type":"string","description":"UTC calendar day, YYYY-MM-DD"},"cents":{"type":"integer","description":"total spend attributed to this day"},"segments":{"type":"array","items":{"$ref":"#/components/schemas/UsageSegment"}}}},"DailyUsage":{"type":"object","required":["daily","previousCents","previousSegments"],"properties":{"daily":{"type":"array","description":"one point per day, oldest first, zero-filled so the series is continuous","items":{"$ref":"#/components/schemas/DailyUsagePoint"}},"previousCents":{"type":"integer","description":"total spend in the same-length window immediately before this one"},"previousSegments":{"type":"array","items":{"$ref":"#/components/schemas/UsageSegment"}}}},"TransferRequest":{"type":"object","required":["id","resourceType","sourceOrganizationId","targetOrganizationId","status","createdAt"],"properties":{"id":{"type":"string"},"resourceType":{"type":"string"},"clusterId":{"type":"string"},"vmId":{"type":"string"},"sourceOrganizationId":{"type":"string"},"targetOrganizationId":{"type":"string"},"initiatedBy":{"type":"string"},"respondedBy":{"type":"string"},"status":{"type":"string"},"note":{"type":"string"},"createdAt":{"type":"string"},"respondedAt":{"type":"string"},"completedAt":{"type":"string"},"expiresAt":{"type":"string"}}},"InitiateTransferRequest":{"type":"object","required":["resourceType","resourceId","targetOrgSlug"],"properties":{"resourceType":{"type":"string","enum":["cluster","vm"]},"resourceId":{"type":"string"},"targetOrgSlug":{"type":"string"},"note":{"type":"string"}}},"AcceptTransferRequest":{"type":"object","properties":{"sshKeyIds":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string"},"description":"SSH key ids of the ACCEPTING org, which replace the source org's on the transferred VM. Required when the transfer moves a vm (at least one id, each naming a live key of the accepting org); ignored for a cluster, which has no per-resource key list."}}},"TransferItem":{"type":"object","required":["id","resourceType","status","resourceName","createdAt"],"properties":{"id":{"type":"string"},"resourceType":{"type":"string"},"clusterId":{"type":"string"},"vmId":{"type":"string"},"status":{"type":"string"},"note":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"respondedAt":{"type":"string"},"completedAt":{"type":"string"},"resourceName":{"type":"string"},"sourceOrgName":{"type":"string"},"sourceOrgSlug":{"type":"string"},"targetOrgName":{"type":"string"},"targetOrgSlug":{"type":"string"}}},"TargetOrg":{"type":"object","required":["id","name","slug"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}}},"ProviderStatus":{"type":"object","required":["isProvider"],"properties":{"isProvider":{"type":"boolean"},"applicationStatus":{"type":"string","nullable":true},"applicationSubmittedAt":{"type":"string","nullable":true}}},"ApplyForProviderRequest":{"type":"object","required":["note"],"properties":{"note":{"type":"string"}}},"ProvisioningTokenItem":{"type":"object","required":["id","tokenPrefix","nodeType","status","createdAt","expiresAt","enrollmentCount"],"properties":{"id":{"type":"string"},"tokenPrefix":{"type":"string"},"name":{"type":"string","nullable":true},"nodeType":{"type":"string"},"status":{"type":"string","description":"active | expired | revoked. A token that has enrolled nodes is still active until it expires or is revoked."},"createdAt":{"type":"string"},"expiresAt":{"type":"string","description":"24 hours after createdAt. Every token expires; the lifetime is fixed."},"enrollmentCount":{"type":"integer","description":"Nodes enrolled with this token so far. There is no cap: a token enrolls any number of nodes while it is valid."},"lastUsedAt":{"type":"string","nullable":true},"nodePool":{"type":"string"},"revokedAt":{"type":"string","nullable":true}}},"GenerateProvisioningTokenRequest":{"type":"object","description":"Every token lives 24 hours from creation and enrolls any number of nodes in that window; neither is a request input. The node runtime is not a token property; each node detects its own shape at enroll (baremetal becomes qemu, a cloud guest becomes runc). Expired and revoked tokens stay listed for 7 days after creation, then fall out.","properties":{"name":{"type":"string"}}},"ProvisioningTokenCreated":{"type":"object","required":["id","token","tokenPrefix","expiresAt","warning"],"properties":{"id":{"type":"string"},"token":{"type":"string"},"tokenPrefix":{"type":"string"},"name":{"type":"string","nullable":true},"expiresAt":{"type":"string","description":"24 hours after creation."},"warning":{"type":"string"},"nodePool":{"type":"string"}}},"EnrollNodeRequest":{"type":"object","required":["token","hardwareFingerprint","nebulaPubkey"],"properties":{"token":{"type":"string","description":"Provisioning token (vtk_...)"},"hardwareFingerprint":{"type":"string"},"machineId":{"type":"string","description":"Stable per-box identity (SMBIOS product_uuid / serial / cloud instance-id). Primary global node-identity key; fingerprint is the fallback when empty."},"hostname":{"type":"string"},"cpuModel":{"type":"string"},"cpuCores":{"type":"integer"},"ramGb":{"type":"integer"},"nebulaPubkey":{"type":"string","description":"Node Nebula public key PEM (from nebula-cert keygen)"},"runtime":{"type":"string","description":"Node runtime, detected on the box by enroll.sh from the host shape: qemu (VFIO/KVM passthrough VM host) on baremetal, runc (GPU-container Pod node) on a cloud guest. The control plane refuses an enroll whose runtime is absent or contradicts hostShape (matched case-insensitively)."},"gpus":{"type":"array","description":"LEGACY nvidia-smi detection (name + pci.bus_id BDF, NOT a vendor:device id despite the example). Kept for old scripts; gpuInventory supersedes it.","items":{"type":"object","required":["pciId"],"properties":{"pciId":{"type":"string","description":"nvidia-smi pci.bus_id (a BDF like 00000000:04:00.0)"},"name":{"type":"string"}}}},"gpuInventory":{"$ref":"#/components/schemas/GpuInventory"},"hostShape":{"$ref":"#/components/schemas/HostShape"},"fabricAgentCapability":{"type":"integer","description":"Pod hosts only: the capability level of the fabric-nodeagent binary on the box (`fabric-nodeagent version`): 1 = a binary predating persistent volumes, 2 = understands --volume-gb, --base-dir and gc-volume, 3 = understands --infiniband, 4 = understands --ib-ip (IPoIB). Admission places a pod only on a node at or above the level its run line needs; the binary has no update channel, so this is what makes a new run flag safe. Absent or 0 on a qemu node."},"ibPartitions":{"type":"array","description":"Pod hosts only: one entry per InfiniBand HCA the box pairs with a GPU, read at enroll from the IPOIB records of `fabric-nodeagent ib-status`. A host with no qualifying HCA, a qemu node, or a binary without the subcommand posts none. It is how the control plane learns which fabric a pod placed on a given GPU would join. An entry missing gpuBdf, hca or pkey refuses the whole enroll with 400 BAD_IB_PARTITIONS: enroll.sh cannot produce one, so it is a bug or a foreign payload, and trimming it would surface only as an entitled pod admitted with no ib0.","items":{"$ref":"#/components/schemas/NodeIBPartition"}},"identityPubkey":{"type":"string","x-go-type-skip-optional-pointer":true,"description":"Node ed25519 identity public key (base64 raw, 32 bytes). The collision-safe node anchor: the box generates this once, keeps the private key at /etc/vectorlay/identity.key, and signs every enroll with it. Required by the server: an enroll without it is refused (401 BAD_SIGNATURE)."},"signedAt":{"type":"integer","x-go-type-skip-optional-pointer":true,"description":"Unix seconds when the enroll body was signed. Required by the server: an unsigned enroll is refused (401 BAD_SIGNATURE); rejected if more than 300s from server time."},"signature":{"type":"string","x-go-type-skip-optional-pointer":true,"description":"base64 ed25519 signature proving possession of identityPubkey over the identity-critical enroll fields (token hash, identity pubkey, nebula pubkey hash, fingerprint, machineId, hostname, signedAt). Required by the server: an enroll without it is refused (401 BAD_SIGNATURE)."}}},"NodeIBPartition":{"type":"object","description":"One InfiniBand HCA a pod host pairs with one of its GPUs, and the fabric that card sits on. The pairing is PCIe adjacency (one HCA per GPU on a root port), so the unit is the card beside a GPU rather than the host: a host may carry HCAs on two partitions, which are two fabrics. Pod admission reads it for two decisions only, whether an IPoIB address can be wired on that GPU and which pool the address is drawn from. Nothing places on it and nothing customer-facing shows it.\n","required":["gpuBdf","hca","pkey"],"properties":{"gpuBdf":{"type":"string","description":"PCI address of the GPU this HCA is paired with, sysfs form (0000:ff:00.0)."},"hca":{"type":"string","description":"RDMA device name of the card (mlx5_4)."},"pkey":{"type":"string","description":"The card's InfiniBand partition: the lowest full-member non-default P_Key of its qualifying port (0x8015). With the node's provider org it is the address-pool key, which is why it carries no subnet-manager LID: a P_Key survives an SM failover, and splitting a pool would let a used-set walk miss live pods."},"smLid":{"type":"string","description":"Subnet manager LID (0x307). Informational: it does separate two fabrics of one provider, but it moves on an SM failover, so no decision reads it."}}},"HostShape":{"type":"object","description":"What the machine ACTUALLY is, detected by enroll.sh. The platform supports two shapes and each has exactly one correct runtime: baremetal => qemu (we convert the GPUs to vfio-pci and rent VMs), guest => runc (we keep the native NVIDIA driver and run pods). The runtime follows the shape on the box, and the control plane refuses any enroll whose runtime contradicts it instead of recording a node that cannot serve its own product. Absent on older node scripts, which the control plane refuses (re-run the bootstrap).\n","properties":{"shape":{"type":"string","description":"baremetal | guest | unknown. unknown means systemd-detect-virt was unavailable; it is NOT treated as baremetal, because that is the direction that tears down a working driver."},"hypervisor":{"type":"string","description":"Raw systemd-detect-virt output (kvm, vmware, none, ...); provenance for the shape."},"hasDevKvm":{"type":"boolean","description":"/dev/kvm exists. A node without it cannot host VMs no matter what its runtime says."},"iommuGroupCount":{"type":"integer","description":"Entries in /sys/kernel/iommu_groups. 0 on a typical cloud guest, which is why pod nodes mint one unit per GPU instead of per IOMMU group."}}},"GpuInventory":{"type":"object","description":"Versioned, driverless GPU detection (lspci) collected by enroll.sh. Works on VFIO hosts with no NVIDIA driver and on non-NVIDIA accelerators. source=none means the node could not detect (no lspci): the control plane must NOT treat that as \"no GPUs\".\n","required":["version","source","devices","nvswitchCount"],"properties":{"version":{"type":"integer"},"source":{"type":"string","description":"none | lspci | lspci+nvidia-smi"},"driverVersion":{"type":"string"},"nvswitchCount":{"type":"integer","description":"NVSwitch bridges (PCI class 0680, vendor 10de) VISIBLE ON THIS MACHINE'S PCI BUS. This answers \"can we pass the switches through to a VM?\", not \"does NVLink work?\": on a virtualised SXM platform the host keeps the switch functions and gives the guest an NVLink partition, so this is 0 while NVLink is fully live. Read nvlinkActive for the latter."},"nvlinkActive":{"type":"boolean","description":"The DRIVER reports live NVLink between GPUs (NV# links in nvidia-smi topo -m). True on a virtualised SXM guest whose nvswitchCount is 0. Absent on older node scripts."},"nvswitchBdfs":{"type":"array","items":{"type":"string"},"description":"Full BDFs of the node's NVSwitch functions (PCI class 0680, vendor 10de), e.g. \"0000:83:00.0\". Full-node (all-GPU) VM placement appends these to the passthrough list so the guest gets the NVLink fabric; partial allocations never receive them. Absent/empty on non-SXM boxes and old enroll scripts.\n"},"devices":{"type":"array","items":{"type":"object","required":["pciDeviceId","count"],"properties":{"pciDeviceId":{"type":"string","description":"vendor:device, e.g. 10de:2204"},"count":{"type":"integer"},"pciClass":{"type":"string","description":"PCI class code, e.g. 0300/0302/1200"},"pciName":{"type":"string","description":"lspci device name string"},"bdfs":{"type":"array","items":{"type":"string"},"description":"full BDFs of the group's devices"}}}},"iommuGroups":{"type":"array","description":"Per-IOMMU-group VFIO units: each entry is one IOMMU group containing an NVIDIA/AMD GPU. A group's GPUs are indivisible (must be passed together). Empty when IOMMU is off (runc pod / CPU nodes): those GPUs are fed via the Nomad device fingerprint instead. Kept out of the hardware fingerprint (BDFs renumber across reboots).\n","items":{"type":"object","required":["group","gpus"],"properties":{"group":{"type":"integer","description":"IOMMU group number (provenance)"},"gpus":{"type":"array","description":"GPU-class (0300/0302) NVIDIA/AMD devices in this group, the sellable + passthrough set","items":{"type":"object","required":["bdf","deviceId"],"properties":{"bdf":{"type":"string","description":"full BDF, e.g. 0000:04:00.0"},"deviceId":{"type":"string","description":"vendor:device, e.g. 10de:2204"}}}}}}}}},"EnrollNodeBundle":{"type":"object","required":["nodeId","nebulaCert","nebulaCa","nebulaOverlayIp","nebulaLighthouses","nomadCa","nomadClientCert","nomadClientKey","nomadServers","nomadIntroToken","nomadPool","datacenter","dataPlaneCert","dataPlaneKey","dataPlaneCa","gatewayAddr","gatewayServerName","nomadClientReset"],"properties":{"nodeId":{"type":"string"},"nebulaCert":{"type":"string"},"nebulaCa":{"type":"string"},"nebulaOverlayIp":{"type":"string"},"nebulaLighthouses":{"type":"array","items":{"type":"object","required":["nebulaIp","endpoint"],"properties":{"nebulaIp":{"type":"string"},"endpoint":{"type":"string","description":"publicIp:4242"}}}},"nomadCa":{"type":"string"},"nomadClientCert":{"type":"string"},"nomadClientKey":{"type":"string"},"nomadServers":{"type":"array","items":{"type":"string"},"description":"server Nebula RPC addrs (ip:4647); literal fallback used when nomadServerName is unset or does not resolve on the node"},"nomadServerName":{"type":"string","description":"stable FQDN whose A records track the live Nomad server overlay IPs; enroll.sh prefers a retry_join on this name (re-resolves on every retry) and falls back to nomadServers when it is empty or the node cannot resolve it; optional"},"nomadIntroToken":{"type":"string"},"nomadClientReset":{"type":"boolean","description":"The control plane has determined the node's Nomad record is gone (record GC'd past node_gc_threshold, or purged) and no live workload is pinned here, so enroll.sh must reset the local Nomad client (stop nomad, kill orphaned VM processes, delete the client state DB) before the fresh introduction token can register a new record. Never set while any workload is placed, so a running VM's processes are never stranded."},"nomadPool":{"type":"string"},"datacenter":{"type":"string"},"dataPlaneCert":{"type":"string","description":"node data-plane mTLS cert (gateway tunnel); optional"},"dataPlaneKey":{"type":"string","description":"node data-plane mTLS key; optional"},"dataPlaneCa":{"type":"string","description":"CertIssuer CA the gateway pins; optional"},"gatewayAddr":{"type":"string","description":"host:port the node-agent dials (QUIC/UDP); optional"},"gatewayServerName":{"type":"string","description":"expected CN on the gateway server cert; optional"},"nodeAgentToken":{"type":"string","description":"durable node token for the node-agent self-update fetch (GET /v1/nodes/agent); optional"}}},"NodeGpuItem":{"type":"object","required":["gpuName","vramGb","quantity"],"properties":{"gpuName":{"type":"string"},"vramGb":{"type":"integer"},"quantity":{"type":"integer"}}},"ProviderNode":{"type":"object","required":["id","hostname","nodeType","tdxEnabled","status","createdAt","gpus"],"properties":{"id":{"type":"string"},"hostname":{"type":"string"},"nodeType":{"type":"string"},"runtime":{"type":"string","description":"Node runtime: qemu (VFIO VM host) or runc (GPU-container Pod node). Empty reads as qemu."},"tdxEnabled":{"type":"boolean"},"status":{"type":"string"},"cpuModel":{"type":"string","nullable":true},"cpuCores":{"type":"integer","nullable":true},"ramGb":{"type":"integer","nullable":true},"createdAt":{"type":"string"},"locationCity":{"type":"string","nullable":true},"locationCountry":{"type":"string","nullable":true},"gpus":{"type":"array","items":{"$ref":"#/components/schemas/NodeGpuItem"}},"reservation":{"$ref":"#/components/schemas/NodeReservationSummary"}}},"ProviderStats":{"type":"object","required":["totalNodes","onlineNodes","offlineNodes","activeTokens"],"properties":{"totalNodes":{"type":"integer"},"onlineNodes":{"type":"integer"},"offlineNodes":{"type":"integer"},"activeTokens":{"type":"integer"}}},"EarningsBreakdownNode":{"type":"object","required":["nodeId","hostname","earningsCents","hours"],"properties":{"nodeId":{"type":"string"},"hostname":{"type":"string"},"grossEarningsCents":{"type":"integer","description":"Customer sell gross for legacy revenue-share records. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"billableGrossCents":{"type":"integer","description":"Customer gross attributable to legacy revenue-share paid-funded hours. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"earningsCents":{"type":"integer"},"hours":{"type":"number","description":"Total hours hosted (paid + free-credit + unpaid)."},"billableHours":{"type":"number","description":"Legacy revenue-share hours that fell in the customer's paid-funding band. Omitted for fixed-only providers."},"earningHours":{"type":"number","description":"Hours owed to the provider. Fixed-hourly contracts use eligible hosted hours; legacy revenue share uses paid-funded hours."},"gpuCount":{"type":"integer","description":"GPU count on this node for the utilization denominator: sellable catalog inventory (Σ NodeGpu.Quantity, excluding unrecognised hardware), falling back to raw detected accelerators (Σ DetectedGpusRaw.Count) when no sellable rows exist. 0 only for a genuine CPU-only node."},"rentedGpuHoursMonth":{"type":"number","description":"GPU-hours rented on this node so far this calendar month (Σ over GPU records of month-clamped hours × the record's gpuCount). The utilizationPercent numerator. NOTE: usage records written before per-record gpuCount was stamped count as 1 GPU (a conservative floor)."},"utilizationPercent":{"type":"number","nullable":true,"description":"Month-to-date utilization: rentedGpuHoursMonth / (gpuCount × hours elapsed this month) × 100, clamped to [0,100]. Null when gpuCount is 0 (CPU node) or the month just started (no elapsed time to measure against). CAVEAT: the denominator uses the node's CURRENT gpuCount, so a node whose GPU inventory changed mid-month is exact only from the change onward (added GPUs understate; removed GPUs can saturate at 100)."}}},"EarningsBreakdownGpu":{"type":"object","required":["gpuModelId","name","earningsCents","hours"],"properties":{"gpuModelId":{"type":"string"},"name":{"type":"string"},"grossEarningsCents":{"type":"integer","description":"Customer sell gross for legacy revenue-share records. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"billableGrossCents":{"type":"integer","description":"Customer gross attributable to legacy revenue-share paid-funded hours. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"earningsCents":{"type":"integer"},"hours":{"type":"number","description":"Total hours hosted."},"billableHours":{"type":"number","description":"Legacy revenue-share hours that fell in the paid band. Omitted for fixed-only providers."},"earningHours":{"type":"number","description":"Hours owed to the provider under fixed-hourly or legacy revenue-share terms."}}},"EarningsBreakdownStream":{"type":"object","required":["stream","earningsCents","hours"],"properties":{"stream":{"type":"string","description":"Income stream: 'gpu' (GPU rentals) or 'cpu' (CPU-only rentals)."},"grossEarningsCents":{"type":"integer","description":"Customer sell gross for legacy revenue-share records in this stream. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"billableGrossCents":{"type":"integer","description":"Customer gross attributable to legacy revenue-share paid-funded hours in this stream. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"earningsCents":{"type":"integer","description":"Provider earnings for this stream, calculated from the locked fixed-hourly rate or the legacy revenue share."},"hours":{"type":"number","description":"Total hours hosted in this stream."},"billableHours":{"type":"number","description":"Legacy revenue-share hours in this stream that fell in the paid band. Omitted for fixed-only providers."},"earningHours":{"type":"number","description":"Hours owed to the provider in this stream."}}},"PayoutItem":{"type":"object","required":["id","type","amountCents","createdAt"],"properties":{"id":{"type":"string"},"type":{"type":"string"},"amountCents":{"type":"integer"},"description":{"type":"string","nullable":true},"createdAt":{"type":"string"}}},"EarningsDailyPoint":{"type":"object","required":["date","earningsCents","hostedHours","billableHours","freeHours","unpaidHours"],"properties":{"date":{"type":"string","description":"UTC day, YYYY-MM-DD."},"earningsCents":{"type":"integer","description":"Provider earnings attributed to this day. Prorated across day boundaries for records spanning days."},"billableGrossCents":{"type":"integer","description":"Customer gross attributable to legacy revenue-share paid-funded hours this day. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"hostedHours":{"type":"number","description":"Total hours hosted this day (all bands)."},"billableHours":{"type":"number","description":"Legacy revenue-share hours in the customer's paid-funding band this day; zero for fixed-contract records."},"earningHours":{"type":"number","description":"Hours owed to the provider this day."},"freeHours":{"type":"number","description":"Legacy revenue-share hours funded by customer free credits this day; zero for fixed-contract records."},"unpaidHours":{"type":"number","description":"Legacy revenue-share hours beyond the customer's free+paid funding this day; zero for fixed-contract records."}}},"ProviderEarnings":{"type":"object","required":["totalEarningsCents","totalHours","currentMonthEarningsCents","currentMonthHours","pendingEarningsCents","availableForPayoutCents","totalPaidOutCents","commissionPercent","byNode","byGpuModel","recentPayouts"],"properties":{"totalEarningsCents":{"type":"integer"},"grossEarningsCents":{"type":"integer","description":"Total customer sell gross for legacy revenue-share records. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"billableGrossCents":{"type":"integer","description":"Total customer gross attributable to legacy revenue-share paid-funded hours. Omitted for fixed-only providers; mixed providers exclude fixed-contract customer economics."},"totalHours":{"type":"number","description":"Total hours hosted across all of this provider's usage."},"billableHours":{"type":"number","description":"Legacy revenue-share hours in customers' paid-funding band. Omitted for fixed-only providers."},"earningHours":{"type":"number","description":"Hours owed to the provider. Fixed-hourly contracts accrue across eligible hosted utilization; legacy revenue share accrues only across paid-funded hours."},"freeCreditHours":{"type":"number","description":"Legacy revenue-share hours funded by customer free credits. Omitted for fixed-only providers and excludes fixed-contract hours in mixed responses."},"unpaidHours":{"type":"number","description":"Legacy revenue-share hours beyond customer free credit and paid balance. Omitted for fixed-only providers and excludes fixed-contract hours in mixed responses."},"currentMonthEarningsCents":{"type":"integer"},"currentMonthHours":{"type":"number"},"pendingEarningsCents":{"type":"integer"},"availableForPayoutCents":{"type":"integer"},"totalPaidOutCents":{"type":"integer"},"commissionPercent":{"type":"integer","description":"Default legacy provider revenue-share percentage. Relevant to legacy records in revenue_share_legacy and mixed responses; fixed records use their locked hourly rate."},"compensationMode":{"type":"string","enum":["revenue_share_legacy","fixed_hourly","mixed"],"description":"How provider earnings in this response were calculated. Optional for backward compatibility; absent means revenue_share_legacy. mixed indicates the selected history contains both fixed-hourly and legacy records."},"byNode":{"type":"array","items":{"$ref":"#/components/schemas/EarningsBreakdownNode"}},"byGpuModel":{"type":"array","items":{"$ref":"#/components/schemas/EarningsBreakdownGpu"}},"byStream":{"type":"array","description":"CPU vs GPU income streams.","items":{"$ref":"#/components/schemas/EarningsBreakdownStream"}},"daily":{"type":"array","description":"Last-30-UTC-day earnings series, oldest first, one point per day (zero-filled). A record's band hours/earnings are prorated onto each day by its share of the record's hosted hours (band placement itself is whole-of-life, so a day's split is an attribution, not a re-run of the waterfall per day).","items":{"$ref":"#/components/schemas/EarningsDailyPoint"}},"activeRentals":{"type":"integer","description":"Currently-running rentals on this provider's nodes (open usage records)."},"recentPayouts":{"type":"array","items":{"$ref":"#/components/schemas/PayoutItem"}}}},"NodeReservationSummary":{"type":"object","description":"Reservation state of this node, from the caller's point of view. Present only when some of the node's GPU units are reserved.","required":["reservedUnitCount","releasedUnitCount"],"properties":{"reservedUnitCount":{"type":"integer","description":"GPU units held exclusively for the audience right now"},"releasedUnitCount":{"type":"integer","description":"GPU units this node's reservations have released to the spot market. They are still the reservation's capacity: anyone may buy them, but only at tier=spot, and the capacity owner can reclaim them at any time."},"reservations":{"type":"array","items":{"$ref":"#/components/schemas/NodeReservation"}}}},"NodeReservation":{"type":"object","description":"Exclusive placement rights for a set of orgs over specific GPU units of one node, for a term. Scoped to units, not GPU counts, because units are the indivisible allocation primitive.","required":["id","nodeId","reservedUnitIds","allowedOrgIds","startsAt","status"],"properties":{"id":{"type":"string"},"nodeId":{"type":"string"},"reservedUnitIds":{"type":"array","items":{"type":"string"}},"releasedUnitIds":{"type":"array","items":{"type":"string"},"description":"The subset of reservedUnitIds currently on the spot market (double sell). Still this reservation's capacity, sellable to anyone at tier=spot only, and reclaimable at any time."},"allowedOrgIds":{"type":"array","items":{"type":"string"},"description":"The audience: orgs that may place workloads on the reserved units."},"managingOrgIds":{"type":"array","items":{"type":"string"},"description":"Orgs that may release these units to the market, reclaim them, and terminate the spot workloads on them, on the node owner's behalf. Being in the audience does not confer this."},"startsAt":{"type":"string"},"endsAt":{"type":"string","description":"Absent = open-ended until cancelled"},"status":{"type":"string","enum":["pending","active","expired","cancelled","needs-review"],"description":"needs-review means the node's GPU topology changed under the reservation: it grants nothing (and withholds its units from everyone) until an operator re-affirms it."},"topologyGen":{"type":"integer","description":"Node topology generation this reservation was written against"},"contractRef":{"type":"string"},"reason":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"terminated":{"type":"array","items":{"type":"string"},"description":"Reclaim only: spot VM ids terminated to free the reclaimed units."},"skipped":{"type":"array","items":{"type":"string"},"description":"Reclaim only: VM ids left running because they are not spot."},"wouldTerminate":{"type":"array","items":{"type":"string"},"description":"Reclaim dry run only: the spot VM ids this call would terminate."},"wouldSkip":{"type":"array","items":{"type":"string"},"description":"Reclaim dry run only: VM ids that would be left running."}}},"CreateNodeReservationRequest":{"type":"object","required":["unitIds","allowedOrgIds"],"properties":{"unitIds":{"type":"array","items":{"type":"string"},"description":"GPU unit ids to reserve (from the node's inventory). Must be sellable units of a reservable class (vfio-group or device-request), and the node must be single-class."},"allowedOrgIds":{"type":"array","items":{"type":"string"},"description":"The audience. The platform ops org is added automatically so we can validate the node."},"managingOrgIds":{"type":"array","items":{"type":"string"},"description":"Orgs allowed to release, reclaim, and terminate spot workloads on these units on the owner's behalf. Omit unless a second org manages this capacity commercially."},"startsAt":{"type":"string","description":"Defaults to now"},"endsAt":{"type":"string","description":"Omit for open-ended"},"contractRef":{"type":"string"},"reason":{"type":"string"}}},"UpdateNodeReservationRequest":{"type":"object","properties":{"endsAt":{"type":"string","description":"Move the term end. Empty string makes it open-ended."},"allowedOrgIds":{"type":"array","items":{"type":"string"},"description":"Replace the audience"},"managingOrgIds":{"type":"array","items":{"type":"string"},"description":"Replace the managing orgs. An empty array removes the delegation."},"reaffirm":{"type":"boolean","description":"Re-pin to the node's current topology and reactivate (clears needs-review)"}}},"ReservationUnitsRequest":{"type":"object","required":["unitIds"],"properties":{"unitIds":{"type":"array","items":{"type":"string"}},"reason":{"type":"string","description":"Recorded in the audit trail."}}},"ReservationReclaimRequest":{"type":"object","required":["unitIds"],"description":"Reclaim takes units back off the spot market and terminates the spot workloads on them, so unlike release it can destroy someone's running VM: hence the dry run.","properties":{"unitIds":{"type":"array","items":{"type":"string"}},"reason":{"type":"string","description":"Recorded in the audit trail."},"dryRun":{"type":"boolean","description":"Report which spot workloads would be terminated, and change nothing: no terminations, and the capacity boundary stays where it is."}}},"ReclaimSpotWorkloadsRequest":{"type":"object","properties":{"unitIds":{"type":"array","items":{"type":"string"},"description":"Limit to these units. Omit to target every spot workload on the node."},"reason":{"type":"string","description":"Recorded in the audit trail."},"dryRun":{"type":"boolean","description":"Report what would be terminated, and terminate nothing."}}},"ReclaimSpotWorkloadsResult":{"type":"object","required":["terminated"],"properties":{"terminated":{"type":"array","items":{"type":"string"},"description":"VM ids terminated (or, on a dry run, that would be)"},"skipped":{"type":"array","items":{"type":"string"},"description":"VM ids left alone because they are not spot"}}},"NodeGpuUnitItem":{"type":"object","description":"One allocatable GPU unit on a node: the thing a reservation is scoped to. The id is what create/release/reclaim take.","required":["id","gpuModelId","sellableGpus","allocClass","state","reservable"],"properties":{"id":{"type":"string","description":"Unit id, e.g. 0000:04:00.0. Pass this to create/release/reclaim."},"gpuModelId":{"type":"string"},"gpuModelName":{"type":"string"},"sellableGpus":{"type":"integer","description":"GPUs this unit sells; indivisible, they go together"},"allocClass":{"type":"string","description":"vfio-group is the VM passthrough path; device-request is the pod/cluster path scheduled by Nomad. Both are reservable when sellable."},"state":{"type":"string","description":"free | claimed"},"claimedBy":{"type":"string","description":"What holds it, e.g. vm:. Present when claimed."},"reservable":{"type":"boolean","description":"Whether this unit can be put in a reservation."},"notReservableReason":{"type":"string","description":"Why not, when reservable is false."},"reservationId":{"type":"string","description":"The reservation governing it, when any."},"released":{"type":"boolean","description":"On the spot market right now (double sell)."}}},"RunnerPool":{"type":"object","required":["id","organizationId","name","githubInstallationId","githubOwner","githubOwnerType","poolRamGb","diskSizeGb","status","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"githubInstallationId":{"type":"integer","format":"int64"},"githubOwner":{"type":"string"},"githubOwnerType":{"type":"string"},"poolRamGb":{"type":"integer"},"diskSizeGb":{"type":"integer"},"runtime":{"type":"string"},"status":{"type":"string"},"subscriptionStatus":{"type":"string"},"trialEndsAt":{"type":"string"},"currentPeriodEnd":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}}},"RunnerPoolItem":{"type":"object","required":["id","organizationId","name","githubInstallationId","githubOwner","githubOwnerType","poolRamGb","diskSizeGb","status","createdAt","updatedAt","activeRunners","usedRamMb","queuedRunners","queuedRamMb"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"githubInstallationId":{"type":"integer","format":"int64"},"githubOwner":{"type":"string"},"githubOwnerType":{"type":"string"},"poolRamGb":{"type":"integer"},"diskSizeGb":{"type":"integer"},"runtime":{"type":"string"},"status":{"type":"string"},"subscriptionStatus":{"type":"string"},"trialEndsAt":{"type":"string"},"currentPeriodEnd":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"activeRunners":{"type":"integer"},"usedRamMb":{"type":"integer"},"queuedRunners":{"type":"integer"},"queuedRamMb":{"type":"integer"}}},"RunnerConnectUrl":{"type":"object","required":["url","installUrl","oauth"],"properties":{"url":{"type":"string"},"installUrl":{"type":"string"},"oauth":{"type":"boolean"}}},"RunnerInstallationsRequest":{"type":"object","required":["code"],"properties":{"code":{"type":"string"},"state":{"type":"string"}}},"RunnerInstallation":{"type":"object","required":["installationId","account","accountType","alreadyConnected","connectGrant"],"properties":{"installationId":{"type":"integer","format":"int64"},"account":{"type":"string"},"accountType":{"type":"string"},"alreadyConnected":{"type":"boolean"},"connectGrant":{"type":"string"}}},"RunnerInstallationsResult":{"type":"object","required":["installations"],"properties":{"installations":{"type":"array","items":{"$ref":"#/components/schemas/RunnerInstallation"}}}},"CreateRunnerPoolRequest":{"type":"object","required":["installationId"],"properties":{"name":{"type":"string"},"installationId":{"type":"integer","format":"int64"},"githubOwner":{"type":"string"},"githubOwnerType":{"type":"string"},"poolRamGb":{"type":"integer"},"diskSizeGb":{"type":"integer"},"grant":{"type":"string"}}},"ResizeRunnerPoolRequest":{"type":"object","required":["poolRamGb"],"properties":{"poolRamGb":{"type":"integer"}}},"DeleteRunnerPoolResult":{"type":"object","required":["status"],"properties":{"status":{"type":"string"}}},"RunnerJob":{"type":"object","required":["id","runnerPoolId","organizationId","status","ramMb","cpus","queuedAt"],"properties":{"id":{"type":"string"},"runnerPoolId":{"type":"string"},"organizationId":{"type":"string"},"githubRepo":{"type":"string"},"runnerName":{"type":"string"},"runnerSizeLabel":{"type":"string"},"ramMb":{"type":"integer"},"cpus":{"type":"integer"},"nodeId":{"type":"string"},"status":{"type":"string"},"queuedAt":{"type":"string"},"provisioningAt":{"type":"string"},"runningAt":{"type":"string"},"completedAt":{"type":"string"},"failureReason":{"type":"string"}}},"RunnerMetricsDaily":{"type":"object","required":["date","completed","failed","cancelled","running"],"properties":{"date":{"type":"string"},"completed":{"type":"integer"},"failed":{"type":"integer"},"cancelled":{"type":"integer"},"running":{"type":"integer"}}},"RunnerMetricsSummary":{"type":"object","required":["totalJobs","completedJobs","failedJobs","avgDurationSec","avgQueueTimeSec"],"properties":{"totalJobs":{"type":"integer"},"completedJobs":{"type":"integer"},"failedJobs":{"type":"integer"},"avgDurationSec":{"type":"integer"},"avgQueueTimeSec":{"type":"integer"}}},"RunnerMetricsCost":{"type":"object","required":["githubCostCents","vectorlayCostCents","savedCents"],"properties":{"githubCostCents":{"type":"integer"},"vectorlayCostCents":{"type":"integer"},"savedCents":{"type":"integer"}}},"RunnerMetrics":{"type":"object","required":["daily","summary","cost"],"properties":{"daily":{"type":"array","items":{"$ref":"#/components/schemas/RunnerMetricsDaily"}},"summary":{"$ref":"#/components/schemas/RunnerMetricsSummary"},"cost":{"$ref":"#/components/schemas/RunnerMetricsCost"}}},"InferenceError":{"type":"object","description":"Error shape returned by the inference endpoint (OpenAI-compatible).","required":["error"],"properties":{"error":{"type":"object","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable explanation."},"type":{"type":"string","description":"Error class, e.g. invalid_request_error."},"code":{"type":"string","description":"Machine code for the specific failure."}}}}},"FileObject":{"type":"object","description":"A file stored for the Batch API (OpenAI-compatible).","required":["id","object","bytes","created_at","filename","purpose"],"properties":{"id":{"type":"string","description":"File id (file-…). Pass it as input_file_id when creating a batch."},"object":{"type":"string","enum":["file"]},"bytes":{"type":"integer","format":"int64","description":"File size in bytes."},"created_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds)."},"expires_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds); files are retained for 30 days."},"filename":{"type":"string"},"purpose":{"type":"string","description":"\"batch\" for inputs, \"batch_output\" / \"batch_error\" for result files."}}},"BatchToolConfig":{"type":"object","description":"The OpenRelay tool-calling extension, carried at body.openrelay.tool_config on a /v1/chat/completions record: where to execute the model's tool calls between turns. When a turn ends with finish_reason \"tool_calls\", the batch worker POSTs the calls to this endpoint, appends the assistant and tool messages, and re-invokes the model, up to max_rounds times. The field is stripped from the body before every model invocation and never appears in result files. A malformed value fails that one record with code invalid_tool_config.\n","required":["url"],"properties":{"type":{"type":"string","enum":["http","mcp"],"default":"http","description":"Executor protocol. \"http\" is the plain POST contract ({custom_id, context, tool_calls} in, {results:[{tool_call_id, content}]} out); \"mcp\" is a Model Context Protocol server speaking Streamable HTTP. Defaults to \"http\".\n"},"url":{"type":"string","format":"uri","description":"Your tool-executor endpoint. HTTPS only, because the request carries your authorization value. Endpoints resolving to internal or private addresses are rejected.\n"},"authorization":{"type":"string","description":"Sent verbatim as the Authorization header on every executor call."},"context":{"type":"object","description":"Opaque JSON forwarded to the executor on every call."},"max_rounds":{"type":"integer","minimum":0,"maximum":16,"default":8,"description":"Maximum tool round-trips for this record. 0 or omitted takes the default of 8; values above 16 are clamped to 16. A record can therefore cost up to max_rounds + 1 model invocations.\n"},"timeout_ms":{"type":"integer","minimum":0,"maximum":120000,"default":30000,"description":"Per-executor-call timeout in milliseconds. 0 or omitted takes the default of 30000; values above 120000 are clamped to 120000.\n"}}},"BatchOpenRelayExtensions":{"type":"object","description":"The reserved \"openrelay\" object on a batch record body: the one top-level key OpenRelay request extensions live under, mirroring the \"openrelay\" response namespace that carries tool_rounds. Additive, so new keys may appear without a breaking change. The worker strips the keys it owns from the body before every model invocation.\n","properties":{"tool_config":{"$ref":"#/components/schemas/BatchToolConfig"}}},"BatchRequestRecord":{"type":"object","description":"One batch request: the same object shape used for each line of a JSONL input file and for each entry of the inline requests array.\n","properties":{"custom_id":{"type":"string","description":"Your identifier for this request, echoed on the matching result line so you can join results back to inputs. Unique within the batch.\n"},"method":{"type":"string","enum":["POST"],"description":"HTTP method for the record; only POST is supported."},"url":{"type":"string","description":"The endpoint this record targets; must match the batch's endpoint."},"body":{"type":"object","description":"The request body you would send to that endpoint online, for example a {model, messages} object for /v1/chat/completions. Streaming is not supported, so \"stream\": true fails that record. A chat record may also carry OpenRelay request extensions under the reserved \"openrelay\" key. A bare top-level tool_config is the retired spelling of that extension and fails the record with code tool_config_moved.\n","properties":{"openrelay":{"$ref":"#/components/schemas/BatchOpenRelayExtensions"}}}}},"BatchRequestCounts":{"type":"object","description":"Progress counters, settled as the batch validates and shards complete.","required":["total","completed","failed"],"properties":{"total":{"type":"integer","format":"int64"},"completed":{"type":"integer","format":"int64"},"failed":{"type":"integer","format":"int64"}}},"BatchUsage":{"type":"object","description":"Rolled-up token and cost totals, present once any progress is recorded. cost_nano_usd is the price you pay (batch discount applied), in nano-USD so sub-cent batches stay exact.\n","required":["input_tokens","output_tokens","cost_nano_usd"],"properties":{"input_tokens":{"type":"integer","format":"int64"},"output_tokens":{"type":"integer","format":"int64"},"cost_nano_usd":{"type":"integer","format":"int64"}}},"BatchObject":{"type":"object","description":"A batch inference job (OpenAI-compatible).","required":["id","object","endpoint","input_file_id","completion_window","status","created_at","request_counts"],"properties":{"id":{"type":"string","description":"Batch id (batch_…)."},"object":{"type":"string","enum":["batch"]},"endpoint":{"type":"string","description":"The API family every record in the batch calls."},"input_file_id":{"type":"string"},"completion_window":{"type":"string","enum":["24h"]},"status":{"type":"string","enum":["validating","in_progress","finalizing","completed","failed","expired","cancelling","cancelled"],"description":"Lifecycle state. validating → in_progress → finalizing → completed | failed | expired; cancelling → cancelled.\n"},"model":{"type":"string","description":"Model id, settled from the input file during validation."},"output_file_id":{"type":"string","description":"Present once results are written; fetch its content for successful records."},"error_file_id":{"type":"string","description":"Present once results are written; fetch its content for failed records."},"created_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds)."},"expires_at":{"type":"integer","format":"int64","description":"When the completion window closes (created_at + 24h)."},"completed_at":{"type":"integer","format":"int64"},"failed_at":{"type":"integer","format":"int64"},"expired_at":{"type":"integer","format":"int64"},"cancelled_at":{"type":"integer","format":"int64"},"request_counts":{"$ref":"#/components/schemas/BatchRequestCounts"},"usage":{"$ref":"#/components/schemas/BatchUsage"},"metadata":{"type":"object","additionalProperties":{"type":"string"},"description":"Your key-value pairs, echoed back unchanged."}}},"BatchList":{"type":"object","description":"One page of batches, newest first (OpenAI list envelope).","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/BatchObject"}},"first_id":{"type":"string","description":"Id of the first batch on this page."},"last_id":{"type":"string","description":"Id of the last batch on this page; pass it as `after` to fetch the next page."},"has_more":{"type":"boolean"}}},"PresignUploadResponse":{"type":"object","description":"A minted file id and a signed URL for a direct browser upload.","required":["file_id","put_url","expires_at"],"properties":{"file_id":{"type":"string","description":"File id to register with the complete call after the PUT succeeds."},"put_url":{"type":"string","description":"Signed URL; PUT the raw JSONL bytes to it."},"expires_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds) the signed URL stops working."}}},"ServingDeployment":{"type":"object","description":"A self-hosted serving deployment: the durable intent to run N replicas of an inference engine for one public catalog model, plus the runtime state the reconcile loop maintains while converging on it.","required":["id","organizationId","publicModelId","engine","servedModelId","gpuModelId","gpuCountPerReplica","replicasMin","replicasMax","replicasDesired","backendWeight","isolated","status","readyReplicas","createdAt","updatedAt"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string","description":"Org that owns the managed replicas (and their metering)"},"publicModelId":{"type":"string","description":"Catalog model this deployment serves capacity for"},"engine":{"type":"string","description":"Inference engine, e.g. vllm or sglang"},"engineImage":{"type":"string","description":"Engine container image override; absent = the engine's default"},"servedModelId":{"type":"string","description":"Model id the engine serves; must equal the catalog backend ref"},"gpuModelId":{"type":"string"},"gpuCountPerReplica":{"type":"integer"},"replicasMin":{"type":"integer"},"replicasMax":{"type":"integer"},"replicasDesired":{"type":"integer"},"weightsRef":{"type":"string","description":"Staged-checkpoint reference; absent = the engine loads from its own source"},"maxModelLen":{"type":"integer"},"quantization":{"type":"string"},"dtype":{"type":"string"},"extraArgs":{"type":"array","items":{"type":"string"}},"env":{"type":"object","additionalProperties":{"type":"string"}},"maxConcurrencyPerReplica":{"type":"integer"},"minPromptBytes":{"type":"integer","description":"Inclusive text-request byte floor for routing eligibility; 0 or absent = unbounded. Routing hint only, not a context limit."},"maxPromptBytes":{"type":"integer","description":"Exclusive text-request byte ceiling for routing eligibility; 0 or absent = unbounded. Routing hint only, not a context limit."},"backendWeight":{"type":"integer","description":"Routing weight of the catalog backend. 0 = standby (blue/green starts here)"},"isolated":{"type":"boolean","description":"True when replicas and their private endpoint pool are for direct operator testing only. Isolated deployments never register a catalog backend, never participate in blue/green rollout, and cannot receive gateway traffic."},"nativeFamilies":{"type":"array","items":{"type":"string"}},"nodePool":{"type":"string","description":"Stable logical capacity lane within the public model. Blue/green only replaces versions in the same node pool; empty preserves legacy model-wide grouping."},"version":{"type":"string","description":"Generation marker for blue/green within one public model and node pool; the target a rolling rollout replaces replicas to"},"rolloutStrategy":{"type":"string","enum":["blue_green","rolling"],"description":"How a version bump reaches the fleet. blue_green (default) mints a ramped sibling; rolling replaces this deployment's replicas in place one at a time."},"maxUnavailable":{"type":"integer","description":"Rolling only: how many replicas may be simultaneously not-ready (absolute count; surfaces show the percentage of desired)."},"rollingActive":{"type":"boolean","description":"True while an in-place rolling rollout is in flight on this deployment."},"rolloutRole":{"type":"string","enum":["","green"],"description":"Opt-in blue/green role. Empty (default) = an INDEPENDENT weighted capacity member of its lane, never blue or green. \"green\" = the lane's successor generation: the controller ramps it against the older members under a capacity guard and cuts them over once it reaches capacity parity. Rollouts are never implicit."},"replicaRuntime":{"type":"string","enum":["","vm","pod"],"description":"How each replica is placed. Absent or \"\" or \"vm\" = a QEMU/VFIO VM on the baremetal fleet (the legacy shape; every pre-existing deployment reads as this). \"pod\" = a hardened GPU pod on a provider-onboarded runc node. One deployment is one runtime; a public model mixes runtimes through lanes."},"rollout":{"$ref":"#/components/schemas/ServingRolloutState"},"parentDeploymentId":{"type":"string","description":"The deployment this one was revised from. Set only by /revise, so an absent value means this deployment was created by hand."},"generation":{"type":"integer","description":"1 for a hand-created deployment, parent+1 for each revision. History ordering only: the controller never reads it, because rollout adoption is the explicit rolloutRole opt-in and nothing else."},"changeCause":{"type":"string","description":"Operator-supplied reason for the revision that created this deployment"},"rolloutPaused":{"type":"boolean","description":"True while an operator has paused the ramp. Traffic is untouched: the deployment keeps the weight it holds and keeps serving, and the controller takes no rollout action until resume. The pause is also on rollout.paused; this raw column is what a surface falls back to when the lane could not be read at all."},"autoscalePaused":{"type":"boolean","description":"True while an operator has frozen the load-driven autoscaler. The min/max band is kept as bounds and reconcile still converges the fleet to replicasDesired; the autoscaler just stops moving replicasDesired on its own. An operator can still hand-set replicasDesired within the band through /scale. Absent when unset."},"status":{"type":"string","enum":["pending","deploying","ready","degraded","scaling","draining","stopped","failed"]},"statusReason":{"type":"string","description":"Human-readable cause for degraded/failed states"},"poolId":{"type":"string","description":"Endpoint pool the deployment's replicas register in"},"replicaVmIds":{"type":"array","items":{"type":"string"}},"readyReplicas":{"type":"integer"},"backendRegistered":{"type":"boolean","description":"Whether this deployment's pool:// backend is currently present on the catalog model row. Absent when the live catalog state could not be read; false until the first replica passes readiness."},"backendHealthy":{"type":"boolean","description":"Live catalog health of this deployment's backend (the kill switch). Only present when backendRegistered is true."},"backendCatalogWeight":{"type":"integer","description":"Live catalog routing weight of this deployment's backend. Only present when backendRegistered is true. May differ from backendWeight (the row mirror) while a rollout ramp is in flight."},"backendVersion":{"type":"string","description":"The rollout tag this deployment's backend reports to the gateway as the `version` metric label on ig_model_requests_total and ig_stream_ttft_seconds. Use it to separate the two sides of a rollout in a dashboard query. Only present when backendRegistered is true."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}}},"ServingRolloutRole":{"type":"string","enum":["independent","blue","green"],"x-enum-varnames":["RolloutRoleViewIndependent","RolloutRoleViewBlue","RolloutRoleViewGreen"],"description":"A deployment's part in its lane RIGHT NOW. independent = carries its own weight and is not in a rollout (also what every lane member is when no green exists). blue = an older member a green is ramping against. green = the opted-in successor."},"ServingRolloutPhase":{"type":"string","enum":["none","waiting_for_replicas","ramping","capacity_hold","at_full_weight","cut_over","rolled_back","paused"],"x-enum-varnames":["RolloutPhaseViewNone","RolloutPhaseViewWaitingForReplicas","RolloutPhaseViewRamping","RolloutPhaseViewCapacityHold","RolloutPhaseViewAtFullWeight","RolloutPhaseViewCutOver","RolloutPhaseViewRolledBack","RolloutPhaseViewPaused"],"description":"Where a roll is. capacity_hold is the state the capacity guard produces: green is ramped as far as its serving capacity justifies and will not advance until it is scaled up. paused is an operator hold: the ramp is frozen at its current share and traffic is untouched, which is categorically weaker than rolled_back."},"ServingRolloutState":{"type":"object","description":"DERIVED rollout state for this deployment's lane (public model + node pool). Computed by the same code that drives the rollout, so an operator surface can never narrate a different story than the controller will execute. Absent when the deployment is isolated, terminal, or the live catalog could not be read.\nforced / forceExpired / forcedBy / forcedReason are the ONLY read of a force-cutover: the arm expires, so the raw stamp on the row answers \"is a force in effect\" wrong roughly as often as it answers it right, and it is deliberately not on the wire.","required":["role","lane","phase"],"properties":{"role":{"$ref":"#/components/schemas/ServingRolloutRole"},"lane":{"type":"string","description":"The lane's label, publicModelId/nodePool"},"laneMemberIds":{"type":"array","items":{"type":"string"},"description":"Every live deployment in this lane, oldest first"},"peerId":{"type":"string","description":"The other side of the roll: for a green, the newest blue it replaces; for a blue, the green replacing it. Absent when the lane is not rolling."},"phase":{"$ref":"#/components/schemas/ServingRolloutPhase"},"laneWeight":{"type":"integer","description":"The lane's full weight: the largest weight any blue carries"},"weightCeiling":{"type":"integer","description":"The highest weight green may carry right now under the capacity guard (its share of the lane's ready serving slots, scaled onto laneWeight)."},"greenSlots":{"type":"integer","description":"Green's ready serving capacity: readyReplicas x maxConcurrencyPerReplica"},"blueSlots":{"type":"integer","description":"The blues' combined ready serving capacity, same unit"},"cutoverReady":{"type":"boolean","description":"Whether green has the capacity parity cutover requires (>=95% of blue's slots)"},"nextAction":{"type":"string","description":"One sentence naming what the controller will do next and why, written by the deciding code itself."},"paused":{"type":"boolean","description":"The green row carries an operator pause. The ramp is frozen at its current share; traffic is untouched."},"forced":{"type":"boolean","description":"Force-cutover is armed AND still inside its window, so the slot-derived gates (the weight ceiling and the parity bar) are being overridden this pass. Readiness, the step limit, and the two-pass separation are never overridden."},"forceExpired":{"type":"boolean","description":"Force-cutover was armed but its window has elapsed, so it is inert. Set instead of forced, so a stale arm reads as expired rather than as an override nobody notices is still in effect."},"forcedBy":{"type":"string","description":"Actor who armed force-cutover"},"forcedReason":{"type":"string","description":"Why force-cutover was armed"},"greenPoolPolicy":{"type":"string","description":"Member-selection policy on the green's endpoint pool"},"bluePoolPolicy":{"type":"string","description":"Member-selection policy on the blue side's endpoint pool. Absent when the lane has no blue with a pool."},"policyMismatch":{"type":"boolean","description":"The two sides run different member-selection policies, so the rollout is not a controlled comparison: whatever the new version measures includes the balancing change."}}},"ServingSpecDiffEntry":{"type":"object","description":"One field that differs between two generations, with the class that decides how it can be changed. Values are stringified for display, so a diff is never a re-usable spec fragment. env diffs report KEYS ONLY (added, removed or changed key names): environment values can carry credentials and are never returned by this API.","required":["field","class"],"properties":{"field":{"type":"string"},"class":{"$ref":"#/components/schemas/ServingSpecFieldClass"},"from":{"type":"string","description":"The source generation's value, stringified; absent when unset"},"to":{"type":"string","description":"The new generation's value, stringified; absent when unset"}}},"ServingSpecFieldClass":{"type":"string","enum":["structural","routing","sizing","replica"],"x-enum-varnames":["ServingSpecClassStructural","ServingSpecClassRouting","ServingSpecClassSizing","ServingSpecClassReplica"],"description":"How a spec field may be changed. structural makes a different lane or tenant and is rejected everywhere. routing is safe to mutate under a running replica (PATCH). sizing is mutable by adding or removing replicas (/scale). replica requires new processes on new hardware, which is the blue/green trigger, and is the default for any field not listed."},"ServingSpecField":{"type":"object","required":["field","class"],"properties":{"field":{"type":"string"},"class":{"$ref":"#/components/schemas/ServingSpecFieldClass"}}},"ServingSpecFieldList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ServingSpecField"}}}},"ServingRolloutCapacity":{"type":"object","description":"What a rollout costs in hardware while BOTH generations run. Preflight asks before anything exists and revise answers as the generation is minted, but the four numbers and the arithmetic behind them are identical, so they are one schema: two copies is how the two surfaces end up warning about different peaks.","properties":{"laneCommittedGpus":{"type":"integer","description":"GPUs the target lane's existing live deployments already commit for this GPU model."},"rolloutPeakGpus":{"type":"integer","description":"Peak GPU demand while the rollout is in flight: the new generation's footprint plus laneCommittedGpus, because both generations hold real hardware until the old one is drained."},"rolloutOk":{"type":"boolean","description":"Whether rolloutPeakGpus fits the serving budget. A WARNING, not a blocker: running a tight rollout and draining the old side as the new one ramps is a legitimate plan."},"rolloutReason":{"type":"string","description":"Why the rollout peak does not fit, in lane terms, when rolloutOk is false"}}},"ServingRevisionResult":{"description":"The outcome of a revise: the new generation's deployment row, what changed against its source, and the rollout capacity warning for running both generations at once.","type":"object","required":["deployment","diff"],"allOf":[{"$ref":"#/components/schemas/ServingRolloutCapacity"},{"type":"object","required":["deployment","diff"],"properties":{"deployment":{"$ref":"#/components/schemas/ServingDeployment"},"diff":{"type":"array","items":{"$ref":"#/components/schemas/ServingSpecDiffEntry"},"description":"Every field that differs from the source generation"}}}]},"ServingRevision":{"type":"object","description":"One generation in a deployment's revision chain.","required":["deployment"],"properties":{"deployment":{"$ref":"#/components/schemas/ServingDeployment"},"diffFromParent":{"type":"array","items":{"$ref":"#/components/schemas/ServingSpecDiffEntry"},"description":"What this generation changed against its parent. Absent for the root generation, and for a generation whose parent row no longer exists."}}},"ServingRevisionPage":{"type":"object","description":"One deployment's whole generation chain. Not paged: the chain is bounded by the walk itself (50 generations), and a history an operator cannot see whole is not a history.","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ServingRevision"}}}},"ServingLaneMember":{"type":"object","description":"One deployment's position in its lane.","required":["id","role","status","liveWeight","share","readyReplicas","replicasDesired"],"properties":{"id":{"type":"string"},"role":{"$ref":"#/components/schemas/ServingRolloutRole"},"status":{"type":"string","description":"The deployment's lifecycle status"},"liveWeight":{"type":"integer","description":"The catalog weight this member's backend currently carries. 0 for an unregistered backend and for a demoted blue, which are different states with the same number: read role and status to tell them apart."},"share":{"type":"integer","description":"This member's percentage of the lane's total weight, rounded. 0 when the lane carries no weight at all."},"backendHealthy":{"type":"boolean","description":"Whether this member's catalog backend is marked healthy. Absent when the catalog could not be read or the backend is not registered at all. Read it with liveWeight: a healthy member at weight 0 is a standby, an unhealthy one has been pulled out of rotation."},"readyReplicas":{"type":"integer"},"replicasDesired":{"type":"integer"}}},"ServingLane":{"type":"object","description":"One capacity lane (public model + node pool) and its members, derived by the same code that drives rollouts.","required":["publicModelId","lane","totalWeight","rolling","members"],"properties":{"publicModelId":{"type":"string"},"nodePool":{"type":"string","description":"Absent or empty = the legacy model-wide lane"},"lane":{"type":"string","description":"The lane's label, publicModelId/nodePool"},"greenId":{"type":"string","description":"The lane's opted-in green; absent when the lane is not rolling"},"totalWeight":{"type":"integer","description":"Sum of the lane members' live catalog weights"},"rolling":{"type":"boolean","description":"The lane has a green with something to replace"},"phase":{"allOf":[{"$ref":"#/components/schemas/ServingRolloutPhase"}],"description":"The lane's rollout phase, derived by the same decision the controller executes. One per LANE, not per member: every member of a rolling lane is in the same rollout. Absent when the lane is not rolling."},"policyMismatch":{"type":"boolean","description":"The lane's members run different pool member-selection policies"},"nextAction":{"type":"string","description":"What the rollout controller will do next on this lane, in one sentence for an operator. The same value the green's rollout state reports. Absent when the lane is not rolling."},"members":{"type":"array","items":{"$ref":"#/components/schemas/ServingLaneMember"},"description":"Oldest first"}}},"ServingLaneList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ServingLane"}}}},"ServingDeploymentPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ServingDeployment"}},"nextCursor":{"type":"string","description":"Opaque; pass back to continue. Absent/empty = no more pages"}}},"CreateServingDeploymentRequest":{"type":"object","required":["organizationId","publicModelId","engine","servedModelId","gpuModelId","gpuCountPerReplica","replicasMin","replicasMax","replicasDesired"],"properties":{"organizationId":{"type":"string","description":"Org the managed replicas run (and meter) under"},"publicModelId":{"type":"string","description":"Catalog model the pool backend registers on. Must already be seeded, with pricing"},"engine":{"type":"string","description":"Must resolve to a known engine (e.g. vllm, sglang)"},"engineImage":{"type":"string","description":"Engine container image override"},"servedModelId":{"type":"string","description":"Must equal the catalog backend ref the gateway rewrites to"},"gpuModelId":{"type":"string"},"gpuCountPerReplica":{"type":"integer"},"replicasMin":{"type":"integer"},"replicasMax":{"type":"integer"},"replicasDesired":{"type":"integer","description":"Must lie within replicasMin..replicasMax"},"weightsRef":{"type":"string","description":"Staged-checkpoint reference; omit to let the engine load from its own source"},"maxModelLen":{"type":"integer"},"quantization":{"type":"string"},"dtype":{"type":"string"},"extraArgs":{"type":"array","items":{"type":"string"}},"env":{"type":"object","additionalProperties":{"type":"string"}},"maxConcurrencyPerReplica":{"type":"integer"},"minPromptBytes":{"type":"integer","description":"Inclusive text-request byte floor for this deployment's routing lane; 0 or absent = unbounded"},"maxPromptBytes":{"type":"integer","description":"Exclusive text-request byte ceiling for this deployment's routing lane; 0 or absent = unbounded"},"backendWeight":{"type":"integer","description":"Initial routing weight; defaults to 0 (standby)"},"isolated":{"type":"boolean","default":false,"description":"Launch and health-check replicas without ever publishing their pool as a catalog backend. Requires backendWeight 0."},"nativeFamilies":{"type":"array","items":{"type":"string"},"description":"Defaults to chat_completions at registration"},"nodePool":{"type":"string","description":"Stable logical capacity lane, e.g. rtx5090 or h100. Deployments in different node pools keep independent routing weights."},"version":{"type":"string"},"rolloutRole":{"type":"string","enum":["","green"],"description":"Omit (or \"\") to create an INDEPENDENT weighted capacity member of the lane. Set \"green\" to start a blue/green rollout that ramps traffic onto this version and eventually demotes the lane's older deployments. A green must start at backendWeight 0, and only one may be live per lane."},"replicaRuntime":{"type":"string","enum":["","vm","pod"],"description":"How each replica is placed. Omit (or \"\" or \"vm\") for a QEMU/VFIO VM on the baremetal fleet (the legacy default). Set \"pod\" to place replicas as hardened GPU pods on provider-onboarded runc nodes; a pod deployment REQUIRES weightsRef (pods never fall back to a hub download). Unknown values are rejected, never coerced to a runtime."},"rolloutStrategy":{"type":"string","enum":["blue_green","rolling"],"description":"How a version bump reaches this deployment's fleet. Omit (or blue_green) for the default sibling-and-ramp rollout. \"rolling\" replaces THIS deployment's replicas in place one at a time (start via the rolling-rollout verb); maxUnavailable bounds how many may be down."},"maxUnavailable":{"type":"integer","minimum":1,"description":"Rolling only: how many replicas may be simultaneously not-ready during a rolling rollout (absolute count; surfaces show the percentage of desired). Defaults to 1 when rolloutStrategy is rolling and this is omitted. Ignored by blue/green."},"acknowledgeLaneJoin":{"type":"boolean","default":false,"description":"Required (true) to create an independent deployment into a lane that already has live deployments. Without it such a create is rejected with LANE_INTENT_REQUIRED naming the lane's current members, because \"add capacity beside the live lane\" and \"replace the live lane\" must never be the same request body. Not stored: it describes this request, not the deployment."}}},"ScaleServingDeploymentRequest":{"type":"object","required":["desired"],"properties":{"desired":{"type":"integer","description":"Target replica count; must lie within replicasMin..replicasMax (as adjusted by this request)"},"replicasMin":{"type":"integer","description":"Optional new lower bound for the replica band. Omitted = keep the current value. desired is validated against the adjusted band."},"replicasMax":{"type":"integer","description":"Optional new upper bound for the replica band. Omitted = keep the current value. desired is validated against the adjusted band."}}},"SetServingDeploymentAutoscaleRequest":{"type":"object","required":["paused"],"properties":{"paused":{"type":"boolean","description":"true freezes the load-driven autoscaler (the band is kept as bounds and reconcile still converges to replicasDesired); false resumes it."}}},"ReviseServingDeploymentRequest":{"type":"object","description":"The next generation's spec, expressed as overrides on the source deployment: a field that is present overrides, a field that is absent is inherited. Rollout mechanics (backendWeight, isolated, rolloutRole, acknowledgeLaneJoin) are deliberately absent from this body: the server owns them, and a revision is always a weight-0 green in the source's lane. Structural fields ARE accepted by the schema so the server can reject them by name: changing one would make a different lane or a different tenant, which is a create, not a revision.","properties":{"changeCause":{"type":"string","description":"Why this revision exists. Stored on the row and shown in the revision history."},"organizationId":{"type":"string","description":"Structural: rejected. A different org is a different tenant."},"publicModelId":{"type":"string","description":"Structural: rejected. A different model is a different lane."},"nodePool":{"type":"string","description":"Structural: rejected. A different node pool is a different lane."},"engine":{"type":"string"},"engineImage":{"type":"string"},"servedModelId":{"type":"string"},"gpuModelId":{"type":"string"},"gpuCountPerReplica":{"type":"integer"},"replicasMin":{"type":"integer"},"replicasMax":{"type":"integer"},"replicasDesired":{"type":"integer"},"weightsRef":{"type":"string"},"maxModelLen":{"type":"integer"},"quantization":{"type":"string"},"dtype":{"type":"string"},"extraArgs":{"type":"array","items":{"type":"string"}},"env":{"type":"object","additionalProperties":{"type":"string"}},"maxConcurrencyPerReplica":{"type":"integer"},"minPromptBytes":{"type":"integer"},"maxPromptBytes":{"type":"integer"},"nativeFamilies":{"type":"array","items":{"type":"string"}},"replicaRuntime":{"type":"string","enum":["","vm","pod"],"description":"Changing the runtime is a replica-class change like any other, so it rolls out rather than mutating in place."},"version":{"type":"string","description":"Rollout tag for the new generation: the low-cardinality `version` metric label the gateway reports, which is what separates the two sides of the roll. ABSENT CLEARS IT rather than inheriting the source's, because a green carrying blue's tag registers the identical label and collapses both sides into one series. Cleared, the green reports as \"green\" against blue's \"blue\". Present sets it explicitly."}}},"PatchServingDeploymentRequest":{"type":"object","description":"In-place edit of routing-class fields: which requests this deployment is eligible for. Only the provided fields change. Fields this schema does not define are NOT applied and are not silently accepted either: the decoder drops them, so a body carrying only such a field names no routing field and is rejected with 400 REQUIRES_NEW_GENERATION rather than answering 200 on a row it did not change. An empty patch is rejected for the same reason. Sending the values the deployment already has is a no-op: 200 with the current row and no write. The patch applies to the one deployment named in the path, never to its lane peer.","properties":{"minPromptBytes":{"type":"integer","description":"Inclusive text-request byte floor; 0 = unbounded"},"maxPromptBytes":{"type":"integer","description":"Exclusive text-request byte ceiling; 0 = unbounded"},"nativeFamilies":{"type":"array","items":{"type":"string"}}}},"ServingRolloutActionRequest":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["pause","resume","rollback","cutover","finalize"],"x-enum-varnames":["ServingRolloutActionPause","ServingRolloutActionResume","ServingRolloutActionRollback","ServingRolloutActionCutover","ServingRolloutActionFinalize"],"description":"pause freezes the ramp at its current share without touching traffic. resume clears the freeze. rollback marks the green's backend unhealthy, which is the one true rollback lever: weight 0 keeps a backend as the overflow tail and would route to the broken version exactly when the lane saturates. cutover arms a supervised force of the capacity gates. finalize drains the demoted blues and returns the lane to steady state."},"reason":{"type":"string","description":"Why. Required for cutover, recorded in the admin audit log with the actor for every action."},"confirm":{"type":"string","description":"Typed confirmation for the actions that cannot be undone cheaply (cutover, finalize): must equal the deployment id."}}},"ServingDeploymentWeightRequest":{"type":"object","required":["weight"],"properties":{"weight":{"type":"integer","description":"Catalog backend routing weight; 0 = standby (NOT a kill switch)"}}},"ServingDeploymentHealthRequest":{"type":"object","required":["healthy"],"properties":{"healthy":{"type":"boolean","description":"false = emergency kill (backend excluded from routing entirely); true = clear the kill"}}},"ServingReplicaLoad":{"type":"object","description":"The replica's last scraped engine load, as published to the gateways. Absent fields mean the engine did not expose the metric; a fabricated zero is never reported.","required":["running","atMs"],"properties":{"running":{"type":"integer","description":"Requests currently executing on the engine"},"waiting":{"type":"integer","description":"Requests queued on the engine; present only when hasWaiting"},"kvUtil":{"type":"number","description":"KV-cache utilization 0..1; present only when hasKvUtil"},"hasWaiting":{"type":"boolean"},"hasKvUtil":{"type":"boolean"},"atMs":{"type":"integer","format":"int64","description":"Publish time, unix milliseconds; readings expire after ~45s"}}},"ServingReplica":{"type":"object","description":"One replica of a serving deployment: the managed VM row joined with its pool-member state and last scraped engine load.","required":["vmId","status","memberState"],"properties":{"vmId":{"type":"string"},"name":{"type":"string"},"nodeId":{"type":"string","description":"Node the replica placed on; absent before placement"},"nodeName":{"type":"string","description":"Memorable display label for nodeId (adjective-noun-hex); absent before placement"},"status":{"type":"string","description":"VM lifecycle status (deploying, running, stopped, terminated, failed); \"unreadable\" when the row could not be read this request"},"statusReason":{"type":"string","description":"Defer/failure reason from dispatch (weights staging, image staging, placement, ...)"},"provisioningStage":{"type":"string"},"hostname":{"type":"string","description":"run.* hostname the gateway dials; the pool-member key"},"gpuCount":{"type":"integer"},"capacity":{"type":"integer","description":"In-flight bound the engine was launched with (= pool member capacity)"},"nomadAllocId":{"type":"string"},"createdAt":{"type":"string"},"memberState":{"type":"string","enum":["active","draining","out","none"],"description":"Pool membership: none = not (yet) a member of the deployment's pool"},"memberCapacity":{"type":"integer","description":"Capacity currently advertised on the pool member; present only when a member exists"},"memberWeight":{"type":"number","format":"double","description":"Ranking weight on the pool member (the warmup/canary dial); absent = full share (1.0)"},"load":{"$ref":"#/components/schemas/ServingReplicaLoad"},"drainHold":{"type":"boolean","description":"An operator has taken this replica out of rotation. The reconcile loop keeps its pool member draining while set, instead of re-activating it once it is ready again."},"drainHoldReason":{"type":"string","description":"Why the replica was held out of rotation"},"runtime":{"type":"string","enum":["vm","pod"],"x-enum-varnames":["ServingReplicaRuntimeVm","ServingReplicaRuntimePod"],"description":"What backs this replica. A LABEL only, derived from the replica row's capability tier: every operator action here is runtime-neutral, because a pool member is a hostname and the pool does not know what serves it."}}},"ServingReplicaList":{"type":"object","required":["items","poolId","policy"],"properties":{"poolId":{"type":"string","description":"The deployment's endpoint pool id"},"policy":{"type":"string","enum":["p2c_util","prefix_affinity"],"description":"The pool's member-selection policy (p2c_util when the pool row does not exist yet)"},"affinityGuardUtil":{"type":"number","format":"double","description":"prefix_affinity overflow bound; absent = the gateway default"},"shedding":{"allOf":[{"$ref":"#/components/schemas/ServingPoolShedding"}],"description":"The pool's load-shedding override; absent when the pool inherits every global/env default (no override set)."},"items":{"type":"array","items":{"$ref":"#/components/schemas/ServingReplica"}},"strayMembers":{"type":"array","items":{"type":"string"},"description":"Pool member hostnames no current replica owns (pending the reconcile loop's stray sweep). Usually empty."}}},"ServingPoolRoutingRequest":{"type":"object","description":"Pool routing knobs; only the provided fields change. policy switches the member-selection algorithm; affinityGuardUtil bounds how full a conversation's home member may run before prefix_affinity overflows to load-only P2C (0 clears it back to the gateway default).","properties":{"policy":{"type":"string","enum":["p2c_util","prefix_affinity"]},"affinityGuardUtil":{"type":"number","format":"double","minimum":0,"maximum":1}}},"ServingPoolShedding":{"type":"object","description":"The pool's OPTIONAL load-shedding override, set and read as one whole block. Every field zero-value (or absent) = inherit the gateway's global/env behavior, so an all-empty block is \"no override\": setting one clears the override back to inherit. As a request body this REPLACES the pool's whole block, so send every field the pool should keep, not just the one changed. Edits the POOL (deployments sharing a pool share it) and reach every gateway task in ~2s via the routing generation stamp. Default-off is unchanged: a deployment that never sets this keeps today's exact behavior.","properties":{"ttftBudgetSec":{"type":"integer","minimum":0,"description":"Per-request first-token budget for this pool's streaming attempts; 0 = the global default."},"firstAttemptTtftSec":{"type":"integer","minimum":0,"description":"Caps attempt 1 of a streaming request when the plan has >= 2 dial targets, so one failover stays affordable. 0 = inherit the global default; capped at half the effective TTFT budget by the gateway."},"exclusionMode":{"type":"string","enum":["","enforce","shadow"],"description":"Overrides global member-health exclusion for this pool. \"enforce\" removes failing members whatever the global env says, \"shadow\" only records, \"\" (or absent) inherits the global decision."},"concurrencyMode":{"type":"string","enum":["","enforce","shadow"],"description":"Overrides global concurrency enforcement for this pool's member caps. \"enforce\" makes the fleet counter decide, \"shadow\" keeps the per-task ceiling deciding, \"\" (or absent) inherits the global decision."},"maxExcludedFraction":{"type":"number","format":"double","minimum":0,"description":"Panic threshold: health exclusion may never remove more than this share of active members at once. Must stay in [0,1) (the exclusive upper bound is enforced by the server); 0 = the gateway default (0.5)."},"brownoutTtftP95Sec":{"type":"integer","minimum":0,"description":"Arms the pool brownout breaker at this rolling-TTFT-p95 threshold; 0 = disabled (the default)."}}},"ServingMemberWeightRequest":{"type":"object","required":["hostname","weight"],"properties":{"hostname":{"type":"string","description":"The pool-member key (the replica's run.* hostname)"},"weight":{"type":"number","format":"double","description":"Ranking share in (0,1]; 1 restores full share"}}},"WeightsRefSummary":{"type":"object","description":"One published checkpoint in the weights manifest.","required":["ref","digest","totalBytes","fileCount"],"properties":{"ref":{"type":"string","description":"The reference deployments use as weightsRef"},"digest":{"type":"string","description":"Content address of the whole checkpoint (sha256 over the sorted file list)"},"totalBytes":{"type":"integer","format":"int64"},"fileCount":{"type":"integer"}}},"WeightsRefList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/WeightsRefSummary"}}}},"ServingPreflightModel":{"type":"object","description":"Catalog-row checks for the target public model.","required":["provided"],"properties":{"provided":{"type":"boolean","description":"publicModelId was passed; the remaining fields are only meaningful when true"},"found":{"type":"boolean","description":"The catalog row exists (the registrar refuses to create one)"},"enabled":{"type":"boolean"},"hasPricing":{"type":"boolean","description":"The row carries at least one pricing dimension; deployments must never invent a price"},"backendCount":{"type":"integer","description":"Backends already on the row (other providers, prior deployments)"}}},"ServingPreflightWeights":{"type":"object","description":"Weights-distribution checks for the requested weightsRef.","required":["configured","provided"],"properties":{"configured":{"type":"boolean","description":"The weights distributor is wired on this control plane (S3_WEIGHTS_BUCKET)"},"provided":{"type":"boolean","description":"weightsRef was passed"},"published":{"type":"boolean","description":"The ref resolves to a digest in the weights manifest"},"digest":{"type":"string"},"totalBytes":{"type":"integer","format":"int64"}}},"ServingPreflightCapacity":{"type":"object","description":"The serving capacity budget, evaluated for the requested footprint.","required":["evaluated","ok"],"properties":{"evaluated":{"type":"boolean","description":"gpuModelId, gpuCountPerReplica and replicasDesired were all passed"},"ok":{"type":"boolean","description":"true when the footprint fits the fleet total"},"fleetTotalGpus":{"type":"integer","description":"Structural fleet size of this GPU model (free + claimed units on online nodes)"},"committedOtherGpus":{"type":"integer","description":"GPUs other active serving deployments of this model already commit"},"requestedGpus":{"type":"integer","description":"replicasDesired x gpuCountPerReplica"},"reason":{"type":"string","description":"The hold reason dispatch would surface, when not ok"},"placableReplicas":{"type":"integer","description":"How many of replicasDesired fit the fleet budget right now (clamp-to-fit admission). Present when evaluated."},"heldReplicas":{"type":"integer","description":"replicasDesired minus placableReplicas: what dispatch would hold with a StatusReason until capacity frees up. 0 when ok. Present when evaluated."},"laneCommittedGpus":{"type":"integer","description":"GPUs the target lane's existing live deployments already commit for this GPU model. Present only when publicModelId (and nodePool) were passed."},"rolloutPeakGpus":{"type":"integer","description":"Peak GPU demand while a rollout is in flight: requestedGpus plus laneCommittedGpus, because the old and new generations both hold real hardware until the old one is drained."},"rolloutOk":{"type":"boolean","description":"Whether rolloutPeakGpus fits the serving budget. This is a WARNING, not a blocker: `ok` still reflects the single-deployment verdict, because running a deliberately tight rollout and draining the old side as the new one ramps is a legitimate plan."},"rolloutReason":{"type":"string","description":"Why the rollout peak does not fit, in lane terms, when rolloutOk is false"}}},"ServingPreflightNodes":{"type":"object","description":"Node-prep checks for the requested GPU model.","required":["evaluated"],"properties":{"evaluated":{"type":"boolean","description":"gpuModelId was passed"},"gpuNodeCount":{"type":"integer","description":"Active nodes with sellable units of this GPU model"},"virtiofsdReadyCount":{"type":"integer","description":"Of those, Nomad-ready nodes carrying the vectorlay_virtiofsd meta. Weights-backed replicas can only place on these; a node enrolled before virtiofsd support must re-enroll. Absent when Nomad was not reachable or weightsRef was not passed (the constraint only applies to weights-backed VMs)."}}},"ServingPreflight":{"type":"object","description":"Read-only pre-deployment checks: everything that must already be true for a serving deployment with the given spec to admit, place, and register. Every check the query parameters make applicable must pass for ok.","required":["ok","model","weights","capacity","nodes","reportStoreConfigured"],"properties":{"ok":{"type":"boolean"},"model":{"$ref":"#/components/schemas/ServingPreflightModel"},"weights":{"$ref":"#/components/schemas/ServingPreflightWeights"},"capacity":{"$ref":"#/components/schemas/ServingPreflightCapacity"},"nodes":{"$ref":"#/components/schemas/ServingPreflightNodes"},"reportStoreConfigured":{"type":"boolean","description":"The node-agent serving-report store (Redis) is configured. Without it the leader reads no readiness reports and pool membership holds forever, so a replica boots, stages, and runs but never joins the pool."}}},"InferenceCatalogModelList":{"type":"object","required":["models"],"properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/InferenceCatalogModel"}}}},"InferenceCatalogBackend":{"type":"object","description":"One place the model can be served, as a traffic surface renders it.","required":["provider","ref","endpoint","weight","healthy"],"properties":{"provider":{"type":"string","description":"selfhosted|bedrock|openrouter|openai|anthropic (openrelay pools report selfhosted)"},"ref":{"type":"string","description":"Provider-side model id / deployment id"},"endpoint":{"type":"string","description":"pool:// for self-hosted capacity; an external URL for managed providers"},"weight":{"type":"integer","description":"Live routing weight (0 = overflow tail)"},"healthy":{"type":"boolean","description":"false = excluded from routing entirely (the kill switch)"},"standby":{"type":"boolean","description":"true = held out of even the overflow tail (an unramped rollout green)"},"version":{"type":"string","description":"Low-cardinality rollout tag, when set"},"accelerator":{"type":"string","description":"Hardware class tag, when known"},"transport":{"type":"string","description":"direct|tunnel|privatelink"},"nativeFamilies":{"type":"array","items":{"type":"string"}},"maxConcurrency":{"type":"integer","description":"Per-backend in-flight cap; 0 = model default"},"minPromptBytes":{"type":"integer"},"maxPromptBytes":{"type":"integer"},"pools":{"type":"array","description":"Self-hosted only: the deployments registering into this pool","items":{"type":"object","properties":{"deploymentId":{"type":"string"},"nodePool":{"type":"string"},"version":{"type":"string"},"status":{"type":"string"}}}}}},"InferenceCatalogModel":{"type":"object","description":"The endpoint-level routing view of one catalog model.","required":["modelId","backends"],"properties":{"modelId":{"type":"string"},"enabled":{"type":"boolean"},"status":{"type":"string"},"routing":{"type":"object","properties":{"strategy":{"type":"string","description":"first_healthy|weighted|sticky (empty = gateway default)"},"maxAttempts":{"type":"integer"},"families":{"type":"object","additionalProperties":{"type":"object","properties":{"strategy":{"type":"string"},"maxAttempts":{"type":"integer"}}}}}},"backends":{"type":"array","items":{"$ref":"#/components/schemas/InferenceCatalogBackend"}},"updatedAt":{"type":"string"}}},"PutInferenceCatalogAllocationRequest":{"type":"object","description":"Percentage traffic targets over EVERY backend of the model.","required":["allocations"],"properties":{"allocations":{"type":"array","items":{"type":"object","required":["endpoint","weightPct"],"properties":{"endpoint":{"type":"string"},"weightPct":{"type":"number","format":"double","minimum":0,"description":"Percent of traffic; all entries must sum to 100"}}}}}},"PatchInferenceCatalogRoutingRequest":{"type":"object","properties":{"strategy":{"type":"string","enum":["first_healthy","weighted","sticky"]},"maxAttempts":{"type":"integer","minimum":1,"maximum":10},"families":{"type":"object","description":"Per-family overrides, keyed by family constant","additionalProperties":{"type":"object","properties":{"strategy":{"type":"string","enum":["first_healthy","weighted","sticky"]},"maxAttempts":{"type":"integer","minimum":1,"maximum":10}}}}}},"CreateInferenceCatalogBackendRequest":{"type":"object","required":["provider","ref","endpoint","nativeFamilies"],"properties":{"provider":{"type":"string","enum":["bedrock","openrouter","openai","anthropic"],"description":"Managed providers only; self-hosted capacity attaches through serving deployments"},"ref":{"type":"string","description":"Provider-side model id"},"endpoint":{"type":"string"},"auth":{"type":"string","enum":["none","bedrock_api_key","api_key","anthropic"],"description":"Auth STYLE the gateway applies to this backend's requests. anthropic sends x-api-key + anthropic-version headers (required by Anthropic- dialect upstreams); api_key sends Authorization: Bearer."},"nativeFamilies":{"type":"array","items":{"type":"string"},"minItems":1},"transport":{"type":"string","enum":["direct","tunnel","privatelink"]},"weight":{"type":"integer","minimum":0,"default":0,"description":"Starting weight; 0 keeps the backend in the overflow tail so attaching moves no traffic"},"maxConcurrency":{"type":"integer","minimum":0}}},"PatchInferenceCatalogBackendRequest":{"type":"object","properties":{"weight":{"type":"integer","minimum":0},"healthy":{"type":"boolean"},"reason":{"type":"string","description":"Audit note, required when flipping the kill switch"},"maxConcurrency":{"type":"integer","minimum":0},"minPromptBytes":{"type":"integer","minimum":0},"maxPromptBytes":{"type":"integer","minimum":0}}},"ServingRollingRolloutRequest":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["start","abort"]},"version":{"type":"string","maxLength":32,"description":"Required for start: the target version tag replicas are replaced to"},"cause":{"type":"string","description":"Free-text reason, recorded in the version history"}}},"ShadowCaptureScope":{"type":"object","description":"One shadow-mode prompt-capture toggle for the inference gateway (notes/shadow-capture-design.md): while active, the gateway mirrors matching (orgId, modelId) request/response payloads to Firehose -> S3 for offline replay/dataset building. orgId and/or modelId may be \"*\" (wildcard); an all-orgs scope additionally requires allowAllOrgs (a second confirm field, so a fat-fingered orgId can never silently become fleet-wide capture).","required":["orgId","modelId","enabled","sampleRate","captureResponse","expiresAt"],"properties":{"orgId":{"type":"string","description":"Org this scope governs, or \"*\" for every org (requires allowAllOrgs)"},"modelId":{"type":"string","description":"Public catalog model this scope governs, or \"*\" for every model"},"enabled":{"type":"boolean"},"sampleRate":{"type":"number","format":"double","minimum":0,"maximum":1,"description":"Fraction of matching requests captured: 0 captures nothing, 1 captures every match"},"captureResponse":{"type":"boolean","description":"Also mirror the response payload (unary: scrubbed body; streaming: usage + timing only, see the gateway's capture-point limitation note). false captures the request + metadata only."},"allowAllOrgs":{"type":"boolean","description":"Required (true) for a scope whose orgId is \"*\"; ignored otherwise"},"expiresAt":{"type":"string","description":"RFC3339 UTC; the scope self-expires here regardless of the DynamoDB TTL sweep timing. Mandatory: a capture toggle that outlives its purpose is a privacy incident."},"note":{"type":"string","description":"Free-text operator note, e.g. what dataset this scope is for"},"createdAt":{"type":"string"},"createdBy":{"type":"string"},"updatedAt":{"type":"string"}}},"PutShadowCaptureScopeRequest":{"type":"object","description":"Creates or replaces the scope for (orgId, modelId). A second PUT for the same pair overwrites the first (upsert), which is how an operator extends a scope's TTL: PUT again with a fresh ttlMinutes.","required":["orgId","modelId","enabled","ttlMinutes"],"properties":{"orgId":{"type":"string","description":"Org to scope capture to, or \"*\" for every org (requires allowAllOrgs: true)"},"modelId":{"type":"string","description":"Public catalog model to scope capture to, or \"*\" for every model"},"enabled":{"type":"boolean"},"sampleRate":{"type":"number","format":"double","minimum":0,"maximum":1,"description":"Defaults to 1.0 (capture every matching request) when omitted"},"ttlMinutes":{"type":"integer","minimum":1,"maximum":1440,"description":"Required. How long the scope stays live from now; the design's mandatory auto-off (max 24h)."},"captureResponse":{"type":"boolean","description":"Defaults to false (request + metadata only) when omitted"},"allowAllOrgs":{"type":"boolean","description":"Must be true when orgId is \"*\"; the second-confirm switch fleet-wide capture requires"},"note":{"type":"string"}}},"ShadowCaptureScopeList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ShadowCaptureScope"}}}},"FeatureFlag":{"type":"object","description":"One feature flag as the admin surface sees it: the compile-time registry entry (services/store/flags) unioned with the stored rows on the config table's FLAGS partition. codeDefault is the durable registry value a cold or errored resolver falls back to; storedDefault (when present) is the fast, no-deploy #DEFAULT row layered over it; overrides are the per-subject allow/deny rows. orphaned marks a stored key with no registry entry (a retired or misspelled flag) so it can be cleaned up rather than vanish.","required":["key","scope","codeDefault","dashboard","effectiveDefault","overrides","orphaned","pending"],"properties":{"key":{"type":"string","description":"Stable flag key (uppercase-with-underscores)"},"description":{"type":"string","description":"Operator-facing copy from the registry; empty for an orphaned key"},"scope":{"type":"string","enum":["global","org","node"],"description":"Which override rows the flag may carry: a global flag has only a default, an org/node flag also takes per-subject overrides. For an orphaned key this is inferred from the subject types of its stored rows."},"codeDefault":{"type":"boolean","description":"Registry Default: the outage/cold floor. false for an orphaned key (its zero value)."},"dashboard":{"type":"boolean","description":"Surfaced to the customer dashboard (the /v1/me flags map)"},"storedDefault":{"type":"boolean","description":"The stored #DEFAULT row's value, when one exists; omitted when only the code default applies"},"storedDefaultUpdatedBy":{"type":"string","description":"Who last wrote the #DEFAULT row"},"storedDefaultUpdatedAt":{"type":"string","description":"When the #DEFAULT row was last written (RFC3339)"},"effectiveDefault":{"type":"boolean","description":"storedDefault when set, else codeDefault: what a subject with no override resolves to"},"overrides":{"type":"array","description":"Per-subject allow/deny rows (empty for a global-scope flag)","items":{"$ref":"#/components/schemas/FeatureFlagSubjectOverride"}},"orphaned":{"type":"boolean","description":"Stored rows exist for a key the registry does not know; it resolves to false at runtime and is cleaned up out of band, never toggled here"},"pending":{"type":"boolean","description":"The resolver does not yet solely drive this flag's behavior, so the admin surface renders it read-only: a toggle would look successful but not take effect. false for every registered flag today; the field is what makes it safe to register and wire a gate ahead of its cutover. false for an orphaned key."},"pendingReason":{"type":"string","description":"Operator-facing reason the flag is read-only; present when pending is true"}}},"FeatureFlagSubjectOverride":{"type":"object","description":"One per-subject override row: an explicit allow (enabled true) or deny (enabled false) that beats the flag's default for that org or node.","required":["subjectType","subjectId","enabled"],"properties":{"subjectType":{"type":"string","enum":["org","node"],"description":"Which subject space the id lives in (maps to the ORG#/NODE# SK prefix)"},"subjectId":{"type":"string","description":"The org id or node id"},"enabled":{"type":"boolean","description":"true = allow this subject, false = deny it (distinct from having no override row)"},"updatedBy":{"type":"string"},"updatedAt":{"type":"string"}}},"FeatureFlagList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/FeatureFlag"}}}},"SetFeatureFlagRequest":{"type":"object","description":"Set the flag's global #DEFAULT row (the fast on/off toggle over the registry default).","required":["enabled","reason"],"properties":{"enabled":{"type":"boolean"},"reason":{"type":"string","minLength":1,"description":"Why the change is made; recorded in the admin audit log, never on the row"}}},"SetFeatureFlagSubjectRequest":{"type":"object","description":"Set a per-subject override row for an org- or node-scoped flag.","required":["enabled","reason"],"properties":{"enabled":{"type":"boolean","description":"true = allow this subject, false = deny it"},"reason":{"type":"string","minLength":1,"description":"Why the change is made; recorded in the admin audit log"}}},"Banner":{"type":"object","description":"One operator-authored dashboard banner (OR-347). message is rendered as plain text downstream (never HTML); ctaUrl is validated server-side to an https:/mailto: allowlist. audience and scope are discriminators, not emptiness: audience \"orgs\" targets exactly orgIds, scope \"paths\" shows only under pathPrefixes (minus excludePaths). contentVersion is a short hash over the visible content and enabledEpoch increments only on a false->true transition, so the dashboard re-shows a dismissed banner on an edit or a re-enable but not on a no-op save.","required":["id","name","enabled","tone","message","dismissible","audience","scope","contentVersion","enabledEpoch"],"properties":{"id":{"type":"string"},"name":{"type":"string","description":"Operator-facing label; not shown to customers."},"enabled":{"type":"boolean"},"tone":{"type":"string","enum":["info","warn","danger"]},"message":{"type":"string","description":"Rendered as plain text."},"ctaLabel":{"type":"string"},"ctaUrl":{"type":"string","description":"https: or mailto: only."},"dismissible":{"type":"boolean"},"audience":{"type":"string","enum":["all","orgs"],"description":"\"all\" targets every org; \"orgs\" targets exactly orgIds."},"orgIds":{"type":"array","items":{"type":"string"}},"scope":{"type":"string","enum":["all","paths"],"description":"\"all\" shows everywhere; \"paths\" shows only under pathPrefixes."},"pathPrefixes":{"type":"array","items":{"type":"string"}},"excludePaths":{"type":"array","items":{"type":"string"}},"contentVersion":{"type":"string"},"enabledEpoch":{"type":"integer","format":"int64"},"createdBy":{"type":"string"},"createdAt":{"type":"string"},"updatedBy":{"type":"string"},"updatedAt":{"type":"string"},"updatedReason":{"type":"string","description":"The audit reason for the row as it stands (operator-facing; absent from the customer shape)."}}},"BannerWriteRequest":{"type":"object","description":"Create a banner. reason is required; it goes to the admin audit log and is stored on the row as updatedReason, which the operator editor pre-fills on the next edit. The update request is BannerUpdateRequest: the same fields plus the required expectedUpdatedAt optimistic lock.","required":["name","enabled","tone","message","dismissible","audience","scope","reason"],"properties":{"name":{"type":"string"},"enabled":{"type":"boolean"},"tone":{"type":"string","enum":["info","warn","danger"]},"message":{"type":"string","minLength":1,"maxLength":500},"ctaLabel":{"type":"string"},"ctaUrl":{"type":"string","description":"https: or mailto: only; rejected otherwise."},"dismissible":{"type":"boolean"},"audience":{"type":"string","enum":["all","orgs"]},"orgIds":{"type":"array","items":{"type":"string"},"description":"Required and non-empty when audience is \"orgs\"; rejected when \"all\"."},"scope":{"type":"string","enum":["all","paths"]},"pathPrefixes":{"type":"array","items":{"type":"string"},"description":"Required and non-empty when scope is \"paths\" (each must start with \"/\"); rejected when \"all\"."},"excludePaths":{"type":"array","items":{"type":"string"}},"reason":{"type":"string","minLength":1,"maxLength":256,"description":"Audit reason (recorded in the admin audit log and stored trimmed on the row as updatedReason)."}}},"BannerUpdateRequest":{"description":"Update a banner: the create fields plus expectedUpdatedAt, the optimistic lock that guards the operator's load-to-submit window. The server conditions the write on the operator-supplied expectedUpdatedAt, so a save can never silently overwrite a concurrent edit.","allOf":[{"$ref":"#/components/schemas/BannerWriteRequest"},{"type":"object","required":["expectedUpdatedAt"],"properties":{"expectedUpdatedAt":{"type":"string","description":"The updatedAt the operator loaded; the write is rejected 409 if the stored banner has changed since."}}}]},"BannerList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Banner"}}}},"OrgBanner":{"type":"object","description":"The customer view of a banner (the enabled subset the dashboard shell renders). Path filtering (scope/pathPrefixes/excludePaths) is applied by the dashboard client, so these fields are carried through for it to use.","required":["id","tone","message","dismissible","scope","contentVersion","enabledEpoch"],"properties":{"id":{"type":"string"},"tone":{"type":"string","enum":["info","warn","danger"]},"message":{"type":"string","description":"Rendered as plain text."},"ctaLabel":{"type":"string"},"ctaUrl":{"type":"string"},"dismissible":{"type":"boolean"},"scope":{"type":"string","enum":["all","paths"]},"pathPrefixes":{"type":"array","items":{"type":"string"}},"excludePaths":{"type":"array","items":{"type":"string"}},"contentVersion":{"type":"string"},"enabledEpoch":{"type":"integer","format":"int64"},"updatedAt":{"type":"string"}}},"OrgBannerList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OrgBanner"}}}}},"responses":{"Unauthorized":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"API key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"The request conflicts with existing state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Gone":{"description":"The resource existed but is no longer usable (e.g. an expired invite)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"BadRequest":{"description":"The request is invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"A required integration (e.g. payments) is not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"CapacityUnavailable":{"description":"The request is valid but the capacity it needs is momentarily unavailable: a transient saturation that clears on node or VM turnover, not a durable conflict. Codes: NODE_AT_CAPACITY, INSUFFICIENT_GPU_CAPACITY, INSUFFICIENT_CPU_CAPACITY, INSUFFICIENT_IP_CAPACITY. Retry the same request with exponential backoff; the Retry-After header suggests how long to wait.","headers":{"Retry-After":{"description":"Suggested seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"BadGateway":{"description":"An upstream dependency answered badly; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InferenceBadRequest":{"description":"The request is invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}},"InferenceUnauthorized":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}},"InferenceNotFound":{"description":"Not found (also returned when the organization does not have Batch API access)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}},"InferenceConflict":{"description":"The resource is in a state that rejects this action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}},"InferenceTooLarge":{"description":"The upload exceeds the 200 MB limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}},"InferenceRateLimited":{"description":"Too many concurrent uploads; retry shortly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}},"InferenceUnavailable":{"description":"The action could not be dispatched; retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceError"}}}}}},"paths":{"/v1/onboarding/bootstrap":{"post":{"operationId":"bootstrap","tags":["Account"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Create the caller's profile and first org (idempotent)","description":"Requires a signed-in dashboard session token; API keys cannot call this endpoint.","security":[{"apiKey":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BootstrapRequest"}}}},"responses":{"200":{"description":"Bootstrapped (or already existed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BootstrapResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/me":{"get":{"operationId":"getMe","tags":["Account"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Current user profile and org memberships","description":"Returns the signed-in user's profile and organization memberships. Requires a dashboard session token; API keys cannot call this endpoint.","security":[{"apiKey":[]}],"responses":{"200":{"description":"The caller's profile + orgs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/me/invites":{"get":{"operationId":"listMyInvites","tags":["Account"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Pending org invites addressed to the signed-in user's email","description":"Returns unexpired pending invites whose invited email matches the session's email. Requires a dashboard session token; API keys are org service accounts and cannot hold or accept invites.","security":[{"apiKey":[]}],"responses":{"200":{"description":"Pending invites for the caller","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MyInvite"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/me/invites/{orgId}/accept":{"post":{"operationId":"acceptOrgInvite","tags":["Account"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Accept a pending org invite (session only)","description":"Creates the membership for the invite addressed to the session's email in the given org, then consumes the invite. This is the only way an invite becomes a membership: the invitee must be authenticated with the invited email and act explicitly.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Joined the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInviteResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"410":{"$ref":"#/components/responses/Gone"}}}},"/v1/me/invites/{orgId}/decline":{"post":{"operationId":"declineOrgInvite","tags":["Account"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Decline a pending org invite (session only)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"204":{"description":"Declined (idempotent)"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/whoami":{"get":{"operationId":"whoami","tags":["Account"],"x-openrelay-mcp":{"default":true},"summary":"The current principal and the org it acts in","description":"Returns the calling principal (API key or user session) and the organization the request acts in. For an API key that org is fixed by the key; for a session it is the active org, and availableOrgs lists every org the user belongs to. Unlike /v1/me this works for API keys and does not onboard.","security":[{"apiKey":[]}],"responses":{"200":{"description":"The caller's principal + acting org","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Whoami"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/me/profile":{"patch":{"operationId":"updateProfile","tags":["Account"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Update the caller's profile","description":"Requires a signed-in dashboard session token; API keys cannot call this endpoint.","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileRequest"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfile"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/members":{"get":{"operationId":"listOrgMembers","tags":["Organizations"],"summary":"List an org's members","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Members","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Member"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/invites":{"get":{"operationId":"listOrgInvites","tags":["Organizations"],"summary":"List an org's pending invites (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Pending invites","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Invite"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/invites/{email}":{"delete":{"operationId":"revokeOrgInvite","tags":["Organizations"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Revoke a pending invite (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Revoked"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/device":{"post":{"operationId":"recordOrgDevice","tags":["Organizations"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Record the browser device the caller is signed in from","description":"Records a Fingerprint visitor id against an existing org. It exists because the dominant signup funnel is the first-login auto-onboard, which creates the org server-side with no request body to carry the device on, so without this endpoint the primary funnel would stay dark. Any member of the org may call it. It never changes access, billing, or org state, and it always returns 204 once authorized, including when the body is empty: a browser that blocked the agent must not see an error.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceSignals"}}}},"responses":{"204":{"description":"Recorded, or ignored when the body carried no device"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs":{"post":{"operationId":"createOrg","tags":["Organizations"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"Create an organization (caller becomes owner)","description":"Requires a signed-in dashboard session token; API keys cannot call this endpoint.","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrgRequest"}}}},"responses":{"200":{"description":"Created (caller is owner)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BootstrapResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}":{"get":{"operationId":"getOrg","tags":["Organizations"],"summary":"Get an organization","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"The organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"operationId":"updateOrg","tags":["Organizations"],"summary":"Update an organization (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrgRequest"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"operationId":"deleteOrg","tags":["Organizations"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true,"destructiveHint":true},"summary":"Delete (soft-delete) an organization (owner only)","description":"Owner-only, reversible soft-delete. Rejects with 409 if the org still has active VMs or a non-zero balance.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/members/add":{"post":{"operationId":"addOrgMember","tags":["Organizations"],"summary":"Invite a member by email (owner/admin)","description":"Records a pending invite and emails the address. The response status is always \"invited\"; the user becomes a member only after they accept (POST /v1/me/invites/{orgId}/accept). Re-inviting the same email refreshes the invite's role and expiry. 409 if the email already belongs to a member.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMemberRequest"}}}},"responses":{"200":{"description":"Added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/members/{userId}":{"patch":{"operationId":"updateOrgMemberRole","tags":["Organizations"],"summary":"Update a member's role (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberRoleRequest"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"operationId":"removeOrgMember","tags":["Organizations"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Remove a member (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Removed"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/clusters/{id}":{"get":{"operationId":"getCluster","tags":["Clusters"],"summary":"Get a cluster by id","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"The cluster","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/clusters/{id}/detail":{"get":{"operationId":"getClusterDetail","tags":["Clusters"],"x-openrelay-mcp":{"default":true},"summary":"Get a cluster with its replicas and GPU model","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"The cluster detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/clusters":{"get":{"operationId":"listOrgClusters","tags":["Clusters"],"x-openrelay-mcp":{"default":true},"summary":"List an org's clusters (cursor-paginated)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Page of clusters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterPage"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/clusters/create":{"post":{"operationId":"createCluster","tags":["Clusters"],"x-openrelay-mcp":{"default":true},"summary":"Create a cluster","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClusterRequest"},"example":{"name":"vllm-serving","replicaCount":2,"gpuModelId":"rtx-4090","gpusPerReplica":1,"imageUrl":"vllm/vllm-openai:latest","containerPort":8000,"healthCheckPath":"/health"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSummary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"503":{"$ref":"#/components/responses/CapacityUnavailable"}}}},"/v1/clusters/{id}/stop":{"post":{"operationId":"stopCluster","tags":["Clusters"],"summary":"Stop a cluster","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/clusters/{id}/restart":{"post":{"operationId":"restartCluster","tags":["Clusters"],"summary":"Restart a cluster","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/clusters/{id}/terminate":{"post":{"operationId":"terminateCluster","tags":["Clusters"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Terminate a cluster","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/clusters/{id}/scale":{"post":{"operationId":"scaleCluster","tags":["Clusters"],"summary":"Scale a cluster's replica count","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScaleRequest"},"example":{"replicaCount":4}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClusterSummary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"503":{"$ref":"#/components/responses/CapacityUnavailable"}}}},"/v1/orgs/{orgId}/vms":{"get":{"operationId":"listOrgVms","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"List an org's VMs (cursor-paginated)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"activeOnly","in":"query","required":false,"schema":{"type":"boolean"},"description":"Return only non-terminated VMs."}],"responses":{"200":{"description":"Page of VMs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmPage"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/vms/{id}":{"get":{"operationId":"getVm","tags":["VMs"],"summary":"Get a VM by id","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"The VM","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/detail":{"get":{"operationId":"getVmDetail","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"Get a VM with its GPU/node/template info and price","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"The VM detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/burn":{"get":{"operationId":"getVmBurn","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"Live burn rate, session cost so far, and org runway for a VM","description":"Every VM bills at one bundled hourly rate (per-GPU catalog price times GPU count for GPU VMs, a flat size rate for CPU VMs); disk is included, never billed separately. The rate is locked when the usage session opens, so this endpoint reads it from the open usage record when one exists (rateSource=locked) and only falls back to the current catalog when nothing is accruing (rateSource=catalog).\n","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"The VM's burn breakdown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmBurn"},"example":{"vmId":"4f6b9a1e-9f1c-4c58-a6a3-1f2f0f6f7a10","pricePerHourCents":411,"rateSource":"locked","rateBasis":"gpu","gpuCount":3,"perGpuCents":137,"diskBilled":false,"accruedSessionCents":1028,"sessionStartedAt":"2026-07-18T09:12:00Z","orgAccruedCents":2120,"orgAccruedMonthCents":2120,"orgAvailableCents":10430,"orgBurnPerHourCents":414,"projectedRunwayHours":25.07,"autoStopFloorCents":50}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/metrics":{"get":{"operationId":"getVmMetrics","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"GPU utilization, memory, power and temperature time series for a pod","description":"$c8","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"},{"name":"range","in":"query","required":false,"description":"Length of the window ending now. A longer range is returned at a coarser step, so the number of points stays bounded.","schema":{"type":"string","enum":["1h","6h","24h","7d"],"x-enum-varnames":["GetVmMetricsParamsRangeN1h","GetVmMetricsParamsRangeN6h","GetVmMetricsParamsRangeN24h","GetVmMetricsParamsRangeN7d"],"default":"1h"}}],"responses":{"200":{"description":"The pod's GPU time series","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmMetrics"},"example":{"vmId":"4f6b9a1e-9f1c-4c58-a6a3-1f2f0f6f7a10","range":"1h","start":"2026-07-18T09:12:00Z","end":"2026-07-18T09:15:00Z","stepSeconds":60,"pointCount":4,"accelerator":{"class":"accelerator","status":"available","source":"nvidia-smi"},"gpus":[{"bdf":"0000:04:00.0","busySeconds":169.2,"series":[{"key":"utilization_ratio","unit":"ratio","values":[0.97,0.94,null,0.91]},{"key":"memory_used_bytes","unit":"bytes","values":[42949672960,43486543872,null,43486543872]}]}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/vms/create":{"post":{"operationId":"createVm","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"Create a VM","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVmRequest"},"example":{"name":"cuda-devbox","gpuModelId":"rtx-4090","gpuCount":1,"imageUrl":"ghcr.io/acme/cuda-devbox:latest","diskSizeGb":100,"sshKeyIds":["key_2f9c1a"],"envVars":{"HF_TOKEN":"hf_xxxxxxxx"}}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"503":{"$ref":"#/components/responses/CapacityUnavailable"}}}},"/v1/vms/{id}/stop":{"post":{"operationId":"stopVm","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"Stop a VM","description":"Stops the workload and releases its GPU. A VM keeps its disk; a pod keeps its /workspace volume and its node, and can be started again with restart.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/vms/{id}/restart":{"post":{"operationId":"restartVm","tags":["VMs"],"summary":"Restart a VM","description":"A running VM reboots in place. A stopped or failed VM is started again. For a pod: from stopped or failed, starts it again on the node that holds its volume, re-claiming GPUs there (409 POD_NODE_BUSY when that node's GPUs are taken, POD_NODE_OFFLINE when the node is offline, POD_NODE_NO_INFINIBAND when the org is enabled for InfiniBand but the node's agent predates it, POD_STOPPING while the previous run is still tearing down); from running, recreates the container (the container filesystem resets, /workspace is kept).","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/vms/{id}/terminate":{"post":{"operationId":"terminateVm","tags":["VMs"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Terminate a VM","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/vms/{id}/reboot":{"post":{"operationId":"rebootVm","tags":["VMs"],"summary":"Reboot a VM","description":"Beta: the reboot request is validated and accepted, but the in-guest reboot is not yet executed by the data plane.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Rebooted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/visibility":{"post":{"operationId":"setVmVisibility","tags":["VMs"],"x-openrelay-mcp":{"default":true},"summary":"Set a VM's endpoint visibility","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetVmVisibilityRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/resize-disk":{"post":{"operationId":"resizeVmDisk","tags":["VMs"],"summary":"Resize a stopped VM's disk","description":"Beta: the new disk size is validated and recorded, but the disk is not yet resized on the node.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResizeDiskRequest"}}}},"responses":{"204":{"description":"Resized"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/telegram-link":{"get":{"operationId":"getVmTelegramLink","tags":["VMs"],"summary":"Get a VM's embedded Telegram link","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelegramLinkResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/vms/{id}/ssh-keys":{"get":{"operationId":"getVmSshKeys","tags":["VMs"],"summary":"SSH keys attached to a VM + the org's keys","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VmSshKeyItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"operationId":"attachVmSshKey","tags":["VMs"],"summary":"Attach an org SSH key to a VM","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachSshKeyRequest"}}}},"responses":{"204":{"description":"Attached"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/vms/{id}/ssh-keys/{keyId}":{"delete":{"operationId":"detachVmSshKey","tags":["VMs"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Detach an org SSH key from a VM","description":"Removes the key from the VM's allowed set. Detaching a key that is not attached is a no-op (204). The last attached key cannot be detached: an empty set would widen access to every org key (the org-wide fallback), so that returns 400.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Detached"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/pods":{"get":{"operationId":"listPods","tags":["Pods"],"x-openrelay-mcp":{"exclude":true},"summary":"List an org's pods (cursor-paginated)","description":"Compute-fabric pods for the org resolved from the API key. A pod is a managed_by=fabric Vm row (capabilityTier=pod), so each item is a VmSummary and paging mirrors listOrgVms.","security":[{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Page of pods","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmPage"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"operationId":"createPod","tags":["Pods"],"x-openrelay-mcp":{"exclude":true},"summary":"Create a pod","description":"Compute-fabric pod (BYO container image + SSH keys): a hardened GPU container on a whole native-driver GPU. Admission claims a free device-request GPU unit (see listPodCapacity for what is claimable), snapshots the on-demand rate immutably onto the pod, and drives the guest workflow.","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePodRequest"},"example":{"name":"cuda-devbox","gpuModelId":"rtx-4090","computeClass":"on_demand","image":"ghcr.io/acme/cuda-devbox:latest","sshKeys":["ssh-ed25519 AAAA... user@host"],"httpPort":8000,"envVars":{"HF_TOKEN":"hf_xxxxxxxx"}}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VmSummary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/pods/capacity":{"get":{"operationId":"listPodCapacity","tags":["Pods"],"x-openrelay-mcp":{"exclude":true},"summary":"Live pod GPU capacity and on-demand rates","description":"What a pod create can actually claim right now, per GPU model: free native (device-request) GPU units on online, non-delisted nodes (the exact filter admission uses), plus the SERVER-computed on-demand hourly rate. Only models with pod units and a price are returned; a create flow should offer exactly these and render these rates verbatim rather than re-deriving prices from the catalog.","security":[{"apiKey":[]}],"responses":{"200":{"description":"Capacity per GPU model, cheapest first","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PodCapacityItem"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/vms/{id}/snapshots":{"post":{"operationId":"createVmSnapshot","tags":["Snapshots"],"x-openrelay-cli":{"group":"VMs"},"summary":"Create a snapshot of a VM","description":"Beta: the snapshot record is created, but snapshot capture is not yet enabled on the data plane.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSnapshotRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedResource"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/snapshots":{"get":{"operationId":"listOrgSnapshots","tags":["Snapshots"],"summary":"List an org's VM snapshots (optionally filtered by source VM)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"vmId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Snapshot"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/snapshots/{id}":{"delete":{"operationId":"deleteSnapshot","tags":["Snapshots"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Soft-delete a snapshot","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/vms/fork":{"post":{"operationId":"forkVm","tags":["Snapshots"],"x-openrelay-cli":{"group":"VMs"},"summary":"Fork a new VM from a snapshot","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForkRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedResource"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"503":{"$ref":"#/components/responses/CapacityUnavailable"}}}},"/v1/orgs/{orgId}/ssh-keys":{"get":{"operationId":"listOrgSshKeys","tags":["SSH Keys"],"summary":"List an org's SSH public keys","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"SSH keys","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SshKeySummary"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/ssh-keys/create":{"post":{"operationId":"createOrgSshKey","tags":["SSH Keys"],"summary":"Add an SSH public key (computes fingerprint)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSshKeyRequest"},"example":{"name":"work-laptop","publicKey":"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIB5ro6Vg2mXKC3jExample user@laptop"}}}},"responses":{"200":{"description":"Added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeySummary"}}}},"400":{"description":"Invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/ssh-keys/{id}":{"delete":{"operationId":"deleteOrgSshKey","tags":["SSH Keys"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Delete an SSH public key","description":"Removes the key from the org and scrubs it from every VM it was attached to. Refused with 409 (code KEY_IN_USE) when it is the only key that still grants access to a VM, since deleting it would strand that VM; attach another key to those VMs first. listOrgSshKeys reports this as blockingVms.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/api-keys":{"get":{"operationId":"listOrgApiKeys","tags":["API Keys"],"summary":"List an org's API keys (no secrets)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"API keys","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApiKeySummary"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/api-keys/create":{"post":{"operationId":"createOrgApiKey","tags":["API Keys"],"summary":"Create an API key (returns the plaintext once)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest"},"example":{"name":"ci-deploy","scopes":["clusters:read","clusters:write","vms:read"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/api-keys/{id}":{"delete":{"operationId":"revokeOrgApiKey","tags":["API Keys"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Revoke an API key","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Revoked"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/registry-credentials":{"get":{"operationId":"listOrgRegistryCredentials","tags":["Registry Credentials"],"summary":"List an org's registry credentials (no secrets)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Registry credentials","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RegistryCredentialSummary"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/registry-credentials/create":{"post":{"operationId":"createOrgRegistryCredential","tags":["Registry Credentials"],"summary":"Create a registry credential (credentials stored encrypted)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRegistryCredentialRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistryCredentialSummary"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/registry-credentials/{id}":{"delete":{"operationId":"deleteOrgRegistryCredential","tags":["Registry Credentials"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Delete a registry credential","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/webhooks":{"get":{"operationId":"listOrgWebhooks","tags":["Webhooks"],"summary":"List an org's webhooks (no secrets)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Webhooks","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSummary"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/webhooks/create":{"post":{"operationId":"createOrgWebhook","tags":["Webhooks"],"summary":"Create a webhook (returns the signing secret once)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookRequest"},"example":{"name":"deploy-events","url":"https://example.com/hooks/openrelay","events":["vm.running","vm.stopped","cluster.degraded"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookWithSecret"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/webhooks/{id}":{"patch":{"operationId":"updateOrgWebhook","tags":["Webhooks"],"summary":"Update a webhook (name/url/events)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookRequest"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUpdateResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"operationId":"deleteOrgWebhook","tags":["Webhooks"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Delete a webhook","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/webhooks/{id}/toggle":{"post":{"operationId":"toggleOrgWebhook","tags":["Webhooks"],"summary":"Enable/disable a webhook","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleWebhookRequest"}}}},"responses":{"200":{"description":"Toggled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookToggleResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/webhooks/{id}/regenerate-secret":{"post":{"operationId":"regenerateOrgWebhookSecret","tags":["Webhooks"],"summary":"Regenerate a webhook's signing secret (returned once)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"Regenerated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSecret"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/webhooks/{id}/deliveries":{"get":{"operationId":"listOrgWebhookDeliveries","tags":["Webhooks"],"summary":"Recent delivery attempts for a webhook","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Deliveries","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveryItem"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/billing/balance":{"get":{"operationId":"getBalance","tags":["Billing"],"x-openrelay-mcp":{"default":true},"summary":"Org balance + recent transactions","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Balance"},"example":{"balanceCents":12550,"availableCents":10430,"accruedUsageCents":2120,"currentMonthUsageCents":2120,"monthlySpendLimitCents":null,"transactions":[{"id":"txn_01hzy3","type":"stripe_deposit","source":"stripe","amountCents":10000,"description":"Card deposit","createdAt":"2026-06-28T14:03:22Z"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/billing/setup-intent":{"post":{"operationId":"createBillingSetupIntent","tags":["Billing"],"summary":"Start saving a card (Stripe SetupIntent for inline Elements)","description":"Returns the SetupIntent client secret the inline Elements form confirms. This operation deliberately takes NO request body, including for device intelligence: oapi-codegen decodes a declared body unconditionally even when it is optional, so adding one would fail every existing client that posts none with a 400 and block card saves. The card-save surface records its device through POST /v1/orgs/{orgId}/device instead.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"SetupIntent client secret + publishable key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetupIntent"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/orgs/{orgId}/billing/deposit":{"post":{"operationId":"createBillingDeposit","tags":["Billing"],"summary":"Charge the saved card to top up prepaid balance","description":"Charges the org's default saved card off-session. The balance credit is applied by the payment_intent.succeeded webhook (the authoritative money signal), not this response: poll the balance after success.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositRequest"},"example":{"amountCents":5000,"idempotencyKey":"dep-2026-07-02-a1b2c3"}}}},"responses":{"200":{"description":"Charge outcome (status drives the dashboard's next step)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/orgs/{orgId}/billing/auto-recharge":{"get":{"operationId":"getAutoRecharge","tags":["Billing"],"summary":"Read the org's auto-recharge policy","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Current settings (defaults when never set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoRechargeSettings"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"put":{"operationId":"updateAutoRecharge","tags":["Billing"],"summary":"Set the org's auto-recharge policy","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoRechargeSettings"}}}},"responses":{"200":{"description":"Saved settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoRechargeSettings"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/orgs/{orgId}/billing/payment-methods":{"get":{"operationId":"listBillingPaymentMethods","tags":["Billing"],"summary":"List saved cards (brand/last4/exp only)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"Saved cards","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethods"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/billing/payment-methods/{paymentMethodId}":{"delete":{"operationId":"deleteBillingPaymentMethod","tags":["Billing"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Remove a saved card","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"paymentMethodId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Removed"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/orgs/{orgId}/billing/payment-methods/{paymentMethodId}/default":{"post":{"operationId":"setBillingPaymentMethod","tags":["Billing"],"summary":"Set a saved card as the default for charges","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"paymentMethodId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Default updated"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/v1/orgs/{orgId}/usage/current":{"get":{"operationId":"getCurrentUsage","tags":["Usage"],"x-openrelay-mcp":{"default":true},"summary":"Current-month usage (cents/hours + per gpuModel-tier breakdown)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentUsage"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/usage/daily":{"get":{"operationId":"getDailyUsage","tags":["Usage"],"summary":"Per-day spend over a trailing window (compute + inference segments)","description":"Display aggregation for the dashboard spend chart. Buckets the org's usage-record cost (clamped per UTC day) and drained inference debits by calendar day, with per-product segments. Read-only: rides the same pricing iterator as settlement and the deploy gate, never re-prices.\n","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":7}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyUsage"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/transfers/target-orgs":{"get":{"operationId":"listTransferTargetOrgs","tags":["Transfers"],"summary":"Orgs the caller belongs to (for the transfer target dropdown)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TargetOrg"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/orgs/{orgId}/transfers":{"post":{"operationId":"initiateTransfer","tags":["Transfers"],"summary":"Initiate a resource transfer to another org (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiateTransferRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferRequest"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/transfers/incoming":{"get":{"operationId":"listIncomingTransfers","tags":["Transfers"],"summary":"Pending incoming transfers (enriched)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TransferItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/transfers/outgoing":{"get":{"operationId":"listOutgoingTransfers","tags":["Transfers"],"summary":"Outgoing transfers, all statuses (enriched)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TransferItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/transfers/pending-count":{"get":{"operationId":"getTransferPendingCount","tags":["Transfers"],"summary":"Count of pending incoming transfers","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingCount"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/transfers/{id}/cancel":{"post":{"operationId":"cancelTransfer","tags":["Transfers"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Cancel a pending outgoing transfer (source org)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Cancelled"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/transfers/{id}/accept":{"post":{"operationId":"acceptTransfer","tags":["Transfers"],"summary":"Accept a pending incoming transfer (target org owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptTransferRequest"}}}},"responses":{"204":{"description":"Accepted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/transfers/{id}/reject":{"post":{"operationId":"rejectTransfer","tags":["Transfers"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Reject a pending incoming transfer (target org owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Rejected"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/provider/bootstrap":{"get":{"operationId":"providerBootstrap","tags":["Provider"],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"summary":"One-command node onboarding installer (auth = org API key bearer, OR a pre-minted provisioning token via ?token=)","description":"Returns a self-contained shell installer (curl | sudo bash). With a bearer org API key it mints a fresh provisioning token (24 hours, any number of nodes); with ?token=vtk_… (e.g. minted from the dashboard) it self-auths and embeds that token instead. name only applies when minting (the token already carries it). Nodes always enroll as QEMU VM hosts in the community pool.\n","security":[{"apiKey":[]},{}],"parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string"},"description":"Pre-minted provisioning token (vtk_…); replaces bearer auth"},{"name":"gpu","in":"query","required":false,"schema":{"type":"string"},"description":"Truthy → run the GPU passthrough (IOMMU + vfio-pci) setup. Safe on CPU-only hosts (self-skips when no GPU is present)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Token label; mint path only"}],"responses":{"200":{"description":"The installer script (contains a secret provisioning token, never cached)","headers":{"Cache-Control":{"schema":{"type":"string"}}},"content":{"text/x-shellscript":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"description":"Missing/invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not an approved provider; a bearer principal without write access to the org (an API key needs clusters:write); or a revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Node artifact unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Onboarding not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/orgs/{orgId}/provider/status":{"get":{"operationId":"getProviderStatus","tags":["Provider"],"summary":"Provider status (isProvider + application status)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderStatus"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/provider/apply":{"post":{"operationId":"applyForProvider","tags":["Provider"],"summary":"Submit a provider application","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyForProviderRequest"}}}},"responses":{"204":{"description":"Submitted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/provider/tokens":{"get":{"operationId":"listProvisioningTokens","tags":["Provider"],"summary":"List the org's provisioning tokens (provider only)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProvisioningTokenItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"operationId":"generateProvisioningToken","tags":["Provider"],"summary":"Generate a provisioning token (owner/admin session, provider org only)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateProvisioningTokenRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisioningTokenCreated"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/provider/tokens/{id}":{"delete":{"operationId":"revokeProvisioningToken","tags":["Provider"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Revoke a provisioning token (owner/admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"204":{"description":"Revoked"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/provider/nodes":{"get":{"operationId":"listProviderNodes","tags":["Provider"],"summary":"List the provider org's nodes (with GPUs + location)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"includeRemoved","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"Filter to one status (online|offline|maintenance|draining|removed)"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProviderNode"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/provider/nodes/{nodeId}":{"patch":{"operationId":"updateProviderNode","tags":["Provider"],"summary":"Set a node's operator lifecycle status (drain / maintenance / remove / online)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"name":"nodeId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["online","draining","maintenance","removed"],"description":"Operator-set lifecycle state. draining/maintenance stop new placement (reconcile leaves them alone, capacity excluded); removed decommissions the node (Phase-1 reaper frees its workloads + GPU units); online clears an operator hold (the next reconcile pass re-derives true liveness from Nomad).\n"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderNode"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/provider/stats":{"get":{"operationId":"getProviderStats","tags":["Provider"],"summary":"Provider node + token stats","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderStats"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/provider/earnings":{"get":{"operationId":"getProviderEarnings","tags":["Provider"],"summary":"Provider earnings from usage records (+ payout history)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderEarnings"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/provider/nodes/{nodeId}/reclaim-spot":{"post":{"operationId":"reclaimSpotWorkloads","tags":["Provider"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Terminate spot workloads running on a node you own or manage","description":"Reclaims capacity by terminating the spot workloads on a node your org owns, or on which your org manages a reservation (managingOrgIds). Scoped strictly to workloads bought at the spot tier: a spot instance is sold on the explicit contract that the capacity owner can terminate it at any time. Non-spot workloads on the node are never touched. Every termination is audited and the affected VM records capacity reclaim as its reason, so the customer is not told it was a platform fault.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/NodeId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReclaimSpotWorkloadsRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReclaimSpotWorkloadsResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/nodes/{nodeId}/reservations/units":{"get":{"operationId":"listReservationUnits","tags":["Reservations"],"x-openrelay-mcp":{"default":true},"summary":"List a node's GPU units, so you can reserve or release them","description":"The allocatable GPU units on one node, with the ids that create, release, and reclaim take. Without this those calls are unusable: they are unit-scoped by design, and nothing else on the API returns a unit id, so the first reservation on a node could not be written at all.\nEach unit is one IOMMU group and is indivisible: a paired unit sells its GPUs together. Sellable units of a reservable class (vfio-group for VMs, device-request for pods/clusters) are reservable, and the response says which, and why not, rather than leaving the caller to infer it from a rejection.\nReadable by a platform operator, the org that owns the node, and any org managing a reservation on it. Anyone else gets 404, so the fleet stays unenumerable.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeGpuUnitItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/nodes/{nodeId}/reservations":{"get":{"operationId":"listNodeReservations","tags":["Reservations"],"summary":"List a node's reservations (platform admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeReservation"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"operationId":"createNodeReservation","tags":["Reservations"],"x-openrelay-mcp":{"exclude":true},"summary":"Reserve GPU units on a node for a set of orgs (platform admin)","description":"Grants exclusive placement rights over specific GPU units for a term. Reserved units disappear from every other org's catalog and cannot be placed on by them. Overlap with an existing reservation is rejected atomically.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateNodeReservationRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeReservation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/nodes/{nodeId}/reservations/{id}":{"get":{"operationId":"getNodeReservation","tags":["Reservations"],"summary":"Get one node reservation (platform admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeReservation"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"operationId":"updateNodeReservation","tags":["Reservations"],"x-openrelay-mcp":{"exclude":true},"summary":"Amend a reservation's term, audience, or topology pin (platform admin)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNodeReservationRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeReservation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/nodes/{nodeId}/reservations/{id}/cancel":{"post":{"operationId":"cancelNodeReservation","tags":["Reservations"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"End a reservation now (platform admin)","description":"Returns the GPU units to the public pool immediately. Workloads the tenant is already running keep running; the node's owning org terminates them when it needs the capacity.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeReservation"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/nodes/{nodeId}/reservations/{id}/release":{"post":{"operationId":"releaseReservationUnits","tags":["Reservations"],"x-openrelay-mcp":{"exclude":true},"summary":"Release GPU units to the spot market (double sell)","description":"The double-sell operation. The named units stay part of the reservation but go on the market: anyone may buy them, at tier=spot and only at tier=spot, which is what makes them terminable by the capacity owner at any time. An ordinary community or verified request will never be placed on them, so released capacity can always be reclaimed. Callable by a platform operator, the org that owns the node, or an org in the reservation's managingOrgIds.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReservationUnitsRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeReservation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/nodes/{nodeId}/reservations/{id}/reclaim":{"post":{"operationId":"reclaimReservationUnits","tags":["Reservations"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Take released GPU units back off the market, evicting spot workloads","description":"Returns the named units to exclusive use AND terminates the spot workloads running on them, in one call. Everything evicted was bought at the spot tier, whose terms are exactly that the capacity owner can reclaim without notice. Pass dryRun to see what would be terminated without changing anything. Callable by a platform operator, the org that owns the node, or an org in the reservation's managingOrgIds.","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/NodeId"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReservationReclaimRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeReservation"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/orgs/{orgId}/reservations":{"get":{"operationId":"listOrgReservations","tags":["Reservations"],"summary":"What GPU capacity is reserved to this org, and until when","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeReservation"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/runner-pools":{"get":{"operationId":"listRunnerPools","tags":["Runners"],"summary":"List runner pools (with active/queued usage)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RunnerPoolItem"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"operationId":"createRunnerPool","tags":["Runners"],"summary":"Create a runner pool","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunnerPoolRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerPool"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/runner-pools/connect-url":{"get":{"operationId":"getRunnerConnectUrl","tags":["Runners"],"summary":"GitHub connect URL (OAuth authorize when configured, else App install)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerConnectUrl"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/runner-pools/installations":{"post":{"operationId":"listRunnerInstallations","tags":["Runners"],"summary":"List GitHub installations the user can connect (OAuth code exchange)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerInstallationsRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerInstallationsResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/orgs/{orgId}/runner-pools/{id}":{"get":{"operationId":"getRunnerPool","tags":["Runners"],"summary":"Get a runner pool (with usage)","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerPoolItem"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"operationId":"deleteRunnerPool","tags":["Runners"],"x-openrelay-mcp":{"destructiveHint":true},"summary":"Delete (or drain) a runner pool","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRunnerPoolResult"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/runner-pools/{id}/resize":{"post":{"operationId":"resizeRunnerPool","tags":["Runners"],"summary":"Resize a runner pool's RAM tier","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResizeRunnerPoolRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerPool"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/runner-pools/{id}/jobs":{"get":{"operationId":"listRunnerJobs","tags":["Runners"],"summary":"List runner jobs for a pool","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RunnerJob"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/orgs/{orgId}/runner-pools/{id}/metrics":{"get":{"operationId":"getRunnerJobMetrics","tags":["Runners"],"summary":"Runner pool job metrics (last 30 days) + cost comparison","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/OrgId"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunnerMetrics"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/models":{"get":{"operationId":"listModels","tags":["Catalog"],"x-openrelay-mcp":{"default":true},"summary":"List models in the OpenRelay catalog (OpenAI-compatible)","description":"Returns the public model catalog. Free, not balance-gated. Models with status \"available\" can be used immediately in /v1/chat/completions; \"request_access\" models are listed for discovery but are not yet invocable.\n","security":[{"apiKey":[]}],"responses":{"200":{"description":"The public model catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/gpu-availability":{"get":{"operationId":"getGpuAvailability","tags":["Catalog"],"x-openrelay-mcp":{"default":true},"summary":"GPU availability by model","description":"Live availability per GPU model. Responses are served from a short-lived cache.","security":[{"apiKey":[]}],"responses":{"200":{"description":"Availability by gpu model","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GpuAvailability"}},"example":[{"gpuModelId":"rtx-4090","vm":{"totalGpus":12,"freeGpus":5,"maxPlaceableGpus":4},"cluster":{"totalGpus":8,"freeGpus":8,"maxPlaceableGpus":8}}]}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/gpu-models":{"get":{"operationId":"listGpuModels","tags":["Catalog"],"x-openrelay-mcp":{"default":true},"summary":"GPU model catalog","security":[{"apiKey":[]}],"responses":{"200":{"description":"GPU models","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GpuModel"}},"example":[{"id":"rtx-4090","name":"RTX 4090","manufacturer":"NVIDIA","vramGb":24,"hidden":false}]}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/pricing":{"get":{"operationId":"getPricing","tags":["Catalog"],"x-openrelay-mcp":{"default":true},"summary":"GPU + CPU pricing","security":[{"apiKey":[]}],"responses":{"200":{"description":"Pricing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pricing"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/vm-templates":{"get":{"operationId":"listVmTemplates","tags":["Catalog"],"x-openrelay-mcp":{"default":true},"summary":"VM template catalog","security":[{"apiKey":[]}],"responses":{"200":{"description":"Templates","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VmTemplate"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/locations":{"get":{"operationId":"listLocations","tags":["Catalog"],"summary":"Locations / regions","security":[{"apiKey":[]}],"responses":{"200":{"description":"Locations","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Location"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/files":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"post":{"operationId":"uploadFile","tags":["Files"],"summary":"Upload a JSONL input file for the Batch API","description":"Send multipart/form-data with a `file` part (the JSONL bytes, up to 200 MB and 50,000 records) and a `purpose` field set to `batch`. Each line is one request object with the BatchRequestRecord shape (including the optional `openrelay.tool_config` extension on chat bodies); the returned file id goes in `input_file_id` when creating a batch.\n","security":[{"apiKey":[]}],"x-openrelay-mcp":{"exclude":true},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file","purpose"],"properties":{"file":{"type":"string","format":"binary","description":"The JSONL file contents."},"purpose":{"type":"string","enum":["batch"]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileObject"}}}},"400":{"$ref":"#/components/responses/InferenceBadRequest"},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"},"413":{"$ref":"#/components/responses/InferenceTooLarge"},"429":{"$ref":"#/components/responses/InferenceRateLimited"}}}},"/v1/files/presign":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"post":{"operationId":"presignFileUpload","tags":["Files"],"summary":"Mint a signed URL for a direct JSONL upload","description":"For browser clients that upload the file straight to storage instead of through the API: returns a file id and a signed PUT URL (valid 15 minutes). After the PUT succeeds, register the file with the complete call. CLI and SDK clients should use the plain upload instead.\n","security":[{"apiKey":[]}],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bytes"],"properties":{"bytes":{"type":"integer","format":"int64","description":"Exact size of the upcoming upload in bytes (max 200 MB)."},"filename":{"type":"string","description":"Display name; not persisted."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadResponse"}}}},"400":{"$ref":"#/components/responses/InferenceBadRequest"},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"}}}},"/v1/files/{id}/complete":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"post":{"operationId":"completeFileUpload","tags":["Files"],"summary":"Register a presigned upload after the PUT succeeds","description":"Validates the uploaded object (size, line count) and registers it as a batch input file. Idempotent; completing an already-registered id returns the existing file.\n","security":[{"apiKey":[]}],"x-openrelay-cli":{"hidden":true},"x-openrelay-mcp":{"exclude":true},"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileObject"}}}},"400":{"$ref":"#/components/responses/InferenceBadRequest"},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"}}}},"/v1/files/{id}":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"get":{"operationId":"getFile","tags":["Files"],"summary":"Get a file's metadata","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileObject"}}}},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"}}}},"/v1/files/{id}/content":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"get":{"operationId":"getFileContent","tags":["Files"],"summary":"Download a file's raw JSONL content","description":"Streams the file bytes. Use it to fetch batch results: the batch object's output_file_id (successful records) and error_file_id (failed records) each point at a JSONL file of `{custom_id, response | error}` lines.\n","security":[{"apiKey":[]}],"x-openrelay-mcp":{"exclude":true},"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"The file's raw JSONL bytes","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"}}}},"/v1/batches":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"post":{"operationId":"createBatch","tags":["Batches"],"summary":"Create a batch inference job","description":"Submit a batch from an uploaded input file (input_file_id) or inline request objects (requests); provide exactly one of the two. The batch completes within the 24h window at a discounted rate; poll it with get, then download results via the output and error file ids.\n","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["endpoint","completion_window"],"properties":{"input_file_id":{"type":"string","description":"Id of an uploaded JSONL input file (from the file upload)."},"requests":{"type":"array","items":{"$ref":"#/components/schemas/BatchRequestRecord"},"description":"Inline request objects (max 50,000), each with a custom_id and the request body for the chosen endpoint. Alternative to input_file_id for small batches.\n"},"endpoint":{"type":"string","enum":["/v1/chat/completions","/v1/completions","/v1/embeddings"],"description":"The API family every record in the batch calls."},"completion_window":{"type":"string","enum":["24h"],"description":"Time budget for the batch; only \"24h\" is supported."},"model":{"type":"string","description":"Optional display hint shown on the batch immediately; validation settles the authoritative value from the input file.\n"},"metadata":{"type":"object","additionalProperties":{"type":"string"},"description":"Up to 16 key-value pairs echoed back on the batch object."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchObject"}}}},"400":{"$ref":"#/components/responses/InferenceBadRequest"},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"},"413":{"$ref":"#/components/responses/InferenceTooLarge"},"429":{"$ref":"#/components/responses/InferenceRateLimited"},"503":{"$ref":"#/components/responses/InferenceUnavailable"}}},"get":{"operationId":"listBatches","tags":["Batches"],"summary":"List batches, newest first","security":[{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Page size, 1-100 (default 20)."},{"name":"after","in":"query","required":false,"schema":{"type":"string"},"description":"A batch id; returns batches submitted after it (use the previous page's last_id)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchList"}}}},"400":{"$ref":"#/components/responses/InferenceBadRequest"},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"}}}},"/v1/batches/{id}":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"get":{"operationId":"getBatch","tags":["Batches"],"summary":"Get a batch by id","security":[{"apiKey":[]}],"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchObject"}}}},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"}}}},"/v1/batches/{id}/cancel":{"servers":[{"url":"https://inference.openrelay.inc","description":"Production"},{"url":"https://inference.beta.openrelay.inc","description":"Beta"}],"post":{"operationId":"cancelBatch","tags":["Batches"],"summary":"Cancel a running batch","description":"In-flight records finish, unstarted records are skipped, and partial results are written; the batch settles to cancelled within a few minutes. Completed work is billed. Batches already in a terminal state return 409.\n","security":[{"apiKey":[]}],"x-openrelay-mcp":{"destructiveHint":true},"parameters":[{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchObject"}}}},"401":{"$ref":"#/components/responses/InferenceUnauthorized"},"404":{"$ref":"#/components/responses/InferenceNotFound"},"409":{"$ref":"#/components/responses/InferenceConflict"},"503":{"$ref":"#/components/responses/InferenceUnavailable"}}}}}}},"proxyUrl":"/api/proxy"}}]

Remove a saved card

Command line

Authorization

Path Parameters

Response Body

204

401application/json

403application/json

503application/json

`application/json`

`application/json`

`application/json`