102 "documentation": "<p>Delete a launch. Marks the launch DELETING and cancels its in-flight Step Functions execution and execution runtime. The record expires through its 24-hour TTL. Right to be forgotten (RTBF) performs user-wide erasure.</p>",
218 "documentation": "<p>Start execution of the deployment plan.</p>"
219 }
220 },
221 "shapes": {
222 "AnalysisResult": {
223 "type": "structure",
224 "required": [
225 "appType",
226 "dependencies",
227 "originPlatform",
228 "hostingPlatformHints",
229 "detectionOutcome"
230 ],
231 "members": {
232 "appType": {
233 "shape": "AppType"
234 },
235 "dependencies": {
236 "shape": "DependencyMap"
237 },
238 "originPlatform": {
239 "shape": "OriginPlatform"
240 },
241 "hostingPlatformHints": {
242 "shape": "StringList"
243 },
244 "detectionOutcome": {
245 "shape": "DetectionOutcome"
246 }
247 }
248 },
249 "AppType": {
250 "type": "string",
251 "documentation": "<p>Application types detected by the analyzer.</p>",
252 "enum": [
253 "replit",
254 "supabase-spa",
255 "supabase-ssr",
256 "react",
257 "vue",
258 "angular",
259 "gatsby",
260 "docusaurus",
261 "cra",
262 "nextjs",
263 "nuxt",
264 "astro",
265 "sveltekit",
266 "solid",
267 "svelte",
268 "preact",
269 "lit",
270 "eleventy",
271 "vitepress",
272 "vite",
273 "unsupported"
274 ]
275 },
276 "Boolean": {
277 "type": "boolean",
278 "box": true
279 },
280 "BranchName": {
281 "type": "string",
282 "documentation": "<p>Git branch name produced by a completed launch.</p>",
283 "max": 256,
284 "min": 1
285 },
286 "ClientToken": {
287 "type": "string",
288 "documentation": "<p>Idempotency token. Any unique string up to 128 characters.</p>",
289 "max": 128,
290 "min": 1
291 },
292 "ConflictException": {
293 "type": "structure",
294 "required": [
295 "message"
296 ],
297 "members": {
298 "message": {
299 "shape": "String"
300 }
301 },
302 "error": {
303 "httpStatusCode": 409,
304 "senderFault": true
305 },
306 "exception": true
307 },
308 "ContextAnswersMap": {
309 "type": "map",
310 "key": {
311 "shape": "String"
312 },
313 "value": {
314 "shape": "String"
315 },
316 "max": 50,
317 "min": 0
318 },
319 "ContextInput": {
320 "type": "structure",
321 "required": [
322 "key",
323 "label",
324 "type"
325 ],
326 "members": {
327 "key": {
328 "shape": "String"
329 },
330 "label": {
331 "shape": "String"
332 },
333 "type": {
334 "shape": "ContextInputType"
335 },
336 "required": {
337 "shape": "Boolean",
338 "documentation": "<p>Whether this input must be answered before the launch can proceed to planning. When true, the launch pauses at AWAITING_INPUT until all required inputs are answered. When false (or omitted), the input is optional context that enriches planning but does not block it.</p>"
339 },
340 "options": {
341 "shape": "ContextInputOptionList",
342 "documentation": "<p>Valid choices when type is SELECT. Agents can pick from these without prompting the user.</p>"
343 },
344 "defaultValue": {
345 "shape": "ContextInputDefaultValueString",
346 "documentation": "<p>Default value if the user provides nothing. Agents may use this to auto-answer optional inputs.</p>"
347 }
348 },
349 "documentation": "<p>A context input that may be presented to the user during the launch flow. Inputs with <code>required: true</code> gate the flow (launch pauses at AWAITING_INPUT). Inputs with <code>required: false</code> or omitted are optional enrichment.</p>"
350 },
351 "ContextInputDefaultValueString": {
352 "type": "string",
353 "max": 256,
354 "min": 0
355 },
356 "ContextInputList": {
357 "type": "list",
358 "member": {
359 "shape": "ContextInput"
360 },
361 "max": 50,
362 "min": 0
363 },
364 "ContextInputOption": {
365 "type": "structure",
366 "required": [
367 "value",
368 "label"
369 ],
370 "members": {
371 "value": {
372 "shape": "ContextInputOptionValueString",
373 "documentation": "<p>The value to submit in contextAnswers.</p>"
374 },
375 "label": {
376 "shape": "ContextInputOptionLabelString",
377 "documentation": "<p>Human-readable label for display.</p>"
378 }
379 },
380 "documentation": "<p>A selectable option for SELECT-type context inputs.</p>"
381 },
382 "ContextInputOptionLabelString": {
383 "type": "string",
384 "max": 256,
385 "min": 1
386 },
387 "ContextInputOptionList": {
388 "type": "list",
389 "member": {
390 "shape": "ContextInputOption"
391 },
392 "max": 20,
393 "min": 0
394 },
395 "ContextInputOptionValueString": {
396 "type": "string",
397 "max": 128,
398 "min": 1
399 },
400 "ContextInputType": {
401 "type": "string",
402 "documentation": "<p>Input type that determines how an agent or UI should render and validate the input.</p>",
403 "enum": [
404 "text",
405 "select",
406 "boolean"
407 ]
408 },
409 "CostBreakdownItem": {
410 "type": "structure",
411 "required": [
412 "service",
413 "monthlyCost"
414 ],
415 "members": {
416 "service": {
417 "shape": "String"
418 },
419 "monthlyCost": {
420 "shape": "Float"
421 },
422 "description": {
423 "shape": "String"
424 },
425 "feature": {
426 "shape": "String",
427 "documentation": "<p>Logical feature category this service belongs to (e.g. "static_hosting", "rest_api").</p>"
428 }
429 }
430 },
431 "CostBreakdownList": {
432 "type": "list",
433 "member": {
434 "shape": "CostBreakdownItem"
435 }
436 },
437 "CreateLaunchInput": {
438 "type": "structure",
439 "required": [
440 "name",
441 "source"
442 ],
443 "members": {
444 "name": {
445 "shape": "CreateLaunchInputNameString",
446 "documentation": "<p>Display name for the launch.</p>"
447 },
448 "source": {
449 "shape": "LaunchSource",
450 "documentation": "<p>Source of the application code. Exactly one variant must be provided.</p>"
451 },
452 "clientToken": {
453 "shape": "ClientToken",
454 "idempotencyToken": true
455 }
456 }
457 },
458 "CreateLaunchInputNameString": {
459 "type": "string",
460 "max": 128,
461 "min": 1
462 },
463 "CreateLaunchOutput": {
464 "type": "structure",
465 "required": [
466 "launch"
467 ],
468 "members": {
469 "launch": {
470 "shape": "Launch"
471 }
472 }
473 },
474 "CreateUploadUrlInput": {
475 "type": "structure",
476 "members": {
477 "clientToken": {
478 "shape": "ClientToken",
479 "idempotencyToken": true
480 }
481 }
482 },
483 "CreateUploadUrlOutput": {
484 "type": "structure",
485 "required": [
486 "uploadUrl",
487 "uploadId"
488 ],
489 "members": {
490 "uploadUrl": {
491 "shape": "SensitiveUrl",
492 "documentation": "<p>Presigned S3 PUT URL (valid for 15 minutes).</p>"
493 },
494 "uploadId": {
495 "shape": "String",
496 "documentation": "<p>Unique upload identifier. Pass to CreateLaunch.</p>"
497 }
498 }
499 },
500 "DeleteLaunchInput": {
501 "type": "structure",
502 "required": [
503 "launchIdentifier"
504 ],
505 "members": {
506 "launchIdentifier": {
507 "shape": "LaunchIdentifier",
508 "location": "uri",
509 "locationName": "launchIdentifier"
510 }
511 }
512 },
513 "DependencyMap": {
514 "type": "map",
515 "key": {
516 "shape": "String"
517 },
518 "value": {
519 "shape": "String"
520 }
521 },
522 "DetectionOutcome": {
523 "type": "string",
524 "documentation": "<p>Outcome of the app detection process.</p>",
525 "enum": [
526 "supported",
527 "detected-not-plannable",
528 "unknown"
529 ]
530 },
531 "FailureCode": {
532 "type": "string",
533 "documentation": "<p>Machine-readable error code describing why a launch failed.</p>",
534 "enum": [
535 "UNSUPPORTED_APP_TYPE",
536 "ANALYSIS_FAILED",
537 "PLANNING_FAILED",
538 "EXECUTION_FAILED",
539 "INTERNAL_ERROR"
540 ]
541 },
542 "FailurePhase": {
543 "type": "string",
544 "documentation": "<p>Phase in which a failure occurred.</p>",
545 "enum": [
546 "analysis",
547 "planning",
548 "execution"
549 ]
550 },
551 "Float": {
552 "type": "float",
553 "box": true
554 },
555 "GetLaunchInput": {
556 "type": "structure",
557 "required": [
558 "launchIdentifier"
559 ],
560 "members": {
561 "launchIdentifier": {
562 "shape": "LaunchIdentifier",
563 "location": "uri",
564 "locationName": "launchIdentifier"
565 },
566 "include": {
567 "shape": "LaunchIncludeSectionList",
568 "documentation": "<p>Sections to include in the response beyond core fields.</p>",
597 "documentation": "<p>Branch to clone (default: repository default branch).</p>"
598 },
599 "connectionId": {
600 "shape": "String",
601 "documentation": "<p>Code Connection ID for private repositories.</p>"
602 }
603 }
604 },
605 "Integer": {
606 "type": "integer",
607 "box": true
608 },
609 "InternalServerException": {
610 "type": "structure",
611 "required": [
612 "message"
613 ],
614 "members": {
615 "message": {
616 "shape": "String"
617 }
618 },
619 "error": {
620 "httpStatusCode": 500
621 },
622 "exception": true,
623 "fault": true
624 },
625 "Launch": {
626 "type": "structure",
627 "required": [
628 "id",
629 "name",
630 "status",
631 "source",
632 "createdAt",
633 "updatedAt"
634 ],
635 "members": {
636 "id": {
637 "shape": "LaunchId"
638 },
639 "name": {
640 "shape": "String"
641 },
642 "status": {
643 "shape": "LaunchStatus"
644 },
645 "source": {
646 "shape": "LaunchSource"
647 },
648 "analysis": {
649 "shape": "AnalysisResult"
650 },
651 "contextInputs": {
652 "shape": "ContextInputList"
653 },
654 "contextAnswers": {
655 "shape": "ContextAnswersMap"
656 },
657 "plan": {
658 "shape": "LaunchPlan"
659 },
660 "costEstimate": {
661 "shape": "LaunchCostEstimate"
662 },
663 "execution": {
664 "shape": "LaunchExecution"
665 },
666 "failureReason": {
667 "shape": "LaunchFailureReason"
668 },
669 "previewUrl": {
670 "shape": "SensitiveUrl"
671 },
672 "downloadUrl": {
673 "shape": "SensitiveUrl"
674 },
675 "outputBranchName": {
676 "shape": "BranchName"
677 },
678 "createdAt": {
679 "shape": "SyntheticTimestamp_date_time"
680 },
681 "updatedAt": {
682 "shape": "SyntheticTimestamp_date_time"
683 }
684 },
685 "documentation": "<p>Full launch representation returned by GetLaunch and mutation operations.</p>"
686 },
687 "LaunchCostEstimate": {
688 "type": "structure",
689 "required": [
690 "estimatedMonthlyCost",
691 "region",
692 "services"
693 ],
694 "members": {
695 "estimatedMonthlyCost": {
696 "shape": "Float"
697 },
698 "region": {
699 "shape": "String"
700 },
701 "services": {
702 "shape": "CostBreakdownList"
703 }
704 }
705 },
706 "LaunchExecution": {
707 "type": "structure",
708 "required": [
709 "completedTasks",
710 "totalTasks"
711 ],
712 "members": {
713 "completedTasks": {
714 "shape": "Integer"
715 },
716 "totalTasks": {
717 "shape": "Integer"
718 },
719 "currentPhase": {
720 "shape": "String"
721 }
722 }
723 },
724 "LaunchFailureReason": {
725 "type": "structure",
726 "required": [
727 "phase",
728 "code",
729 "message"
730 ],
731 "members": {
732 "phase": {
733 "shape": "FailurePhase"
734 },
735 "code": {
736 "shape": "FailureCode"
737 },
738 "message": {
739 "shape": "String"
740 }
741 }
742 },
743 "LaunchId": {
744 "type": "string",
745 "documentation": "<p>Opaque service-generated launch ID used in response bodies. Per AWS Identifier RFC 1.1.7: generic constraints only, no implementation details.</p>",
746 "max": 64,
747 "min": 1,
748 "pattern": "[a-z0-9]+"
749 },
750 "LaunchIdentifier": {
751 "type": "string",
752 "documentation": "<p>Launch identifier. Accepts a launch ID or ARN.</p>",
753 "max": 2048,
754 "min": 1
755 },
756 "LaunchIncludeSection": {
757 "type": "string",
758 "documentation": "<p>Sections that can be included in the GetLaunch response.</p>",
759 "enum": [
760 "analysis",
761 "context_inputs",
762 "plan",
763 "execution",
764 "task_logs",
765 "cost_estimate",
766 "preview_url",
767 "download_url"
768 ]
769 },
770 "LaunchIncludeSectionList": {
771 "type": "list",
772 "member": {
773 "shape": "LaunchIncludeSection"
774 }
775 },
776 "LaunchPhase": {
777 "type": "structure",
778 "required": [
779 "id",
780 "name",
781 "order",
782 "status",
783 "tasks"
784 ],
785 "members": {
786 "id": {
787 "shape": "String"
788 },
789 "name": {
790 "shape": "String"
791 },
792 "order": {
793 "shape": "Integer"
794 },
795 "status": {
796 "shape": "PhaseStatus"
797 },
798 "tasks": {
799 "shape": "LaunchTaskList"
800 }
801 }
802 },
803 "LaunchPhaseList": {
804 "type": "list",
805 "member": {
806 "shape": "LaunchPhase"
807 },
808 "max": 20,
809 "min": 0
810 },
811 "LaunchPlan": {
812 "type": "structure",
813 "required": [
814 "id",
815 "phases"
816 ],
817 "members": {
818 "id": {
819 "shape": "String"
820 },
821 "phases": {
822 "shape": "LaunchPhaseList"
823 }
824 }
825 },
826 "LaunchSource": {
827 "type": "structure",
828 "members": {
829 "s3Upload": {
830 "shape": "S3UploadSource",
831 "documentation": "<p>Upload a local archive via presigned URL.</p>"
832 },
833 "gitHub": {
834 "shape": "GitHubSource",
835 "documentation": "<p>Clone from a GitHub repository.</p>"
836 }
837 },
838 "documentation": "<p>Source specification for a launch.</p>",
881 "documentation": "<p>Summary representation for list endpoints.</p>"
882 },
883 "LaunchSummaryList": {
884 "type": "list",
885 "member": {
886 "shape": "LaunchSummary"
887 }
888 },
889 "LaunchTask": {
890 "type": "structure",
891 "required": [
892 "id",
893 "name",
894 "status",
895 "order"
896 ],
897 "members": {
898 "id": {
899 "shape": "String"
900 },
901 "name": {
902 "shape": "String"
903 },
904 "status": {
905 "shape": "TaskStatus"
906 },
907 "order": {
908 "shape": "Integer"
909 },
910 "outputLog": {
911 "shape": "LaunchTaskOutputLogString",
912 "documentation": "<p>Execution output hydrated on demand when GetLaunch includes task_logs. Truncated to approximately 10,000 characters by the backend.</p>"
1052 "documentation": "<p>The uploadId returned by CreateUploadUrl.</p>"
1053 }
1054 }
1055 },
1056 "SensitiveUrl": {
1057 "type": "string",
1058 "documentation": "<p>URL containing embedded credentials (presigned S3 URLs, signed cookie URLs). Marked sensitive to prevent SDK-level logging of credential material.</p>",
1059 "sensitive": true
1060 },
1061 "ServiceUnavailableException": {
1062 "type": "structure",
1063 "required": [
1064 "message"
1065 ],
1066 "members": {
1067 "message": {
1068 "shape": "String"
1069 }
1070 },
1071 "error": {
1072 "httpStatusCode": 503
1073 },
1074 "exception": true,
1075 "fault": true,
1076 "retryable": {
1077 "throttling": false
1078 }
1079 },
1080 "StartLaunchExecutionInput": {
1081 "type": "structure",
1082 "required": [
1083 "launchIdentifier"
1084 ],
1085 "members": {
1086 "launchIdentifier": {
1087 "shape": "LaunchIdentifier",
1088 "location": "uri",
1089 "locationName": "launchIdentifier"
1090 },
1091 "clientToken": {
1092 "shape": "ClientToken",
1093 "idempotencyToken": true
1094 }
1095 }
1096 },
1097 "StartLaunchExecutionOutput": {
1098 "type": "structure",
1099 "required": [
1100 "launch"
1101 ],
1102 "members": {
1103 "launch": {
1104 "shape": "Launch"
1105 }
1106 }
1107 },
1108 "String": {
1109 "type": "string"
1110 },
1111 "StringList": {
1112 "type": "list",
1113 "member": {
1114 "shape": "String"
1115 }
1116 },
1117 "SyntheticTimestamp_date_time": {
1118 "type": "timestamp",
1119 "timestampFormat": "iso8601"
1120 },
1121 "TaskStatus": {
1122 "type": "string",
1123 "enum": [
1124 "pending",
1125 "running",
1126 "completed",
1127 "failed",
1128 "paused",
1129 "blocked"
1130 ]
1131 },
1132 "ThrottlingException": {
1133 "type": "structure",
1134 "required": [
1135 "message"
1136 ],
1137 "members": {
1138 "message": {
1139 "shape": "String"
1140 }
1141 },
1142 "error": {
1143 "httpStatusCode": 429,
1144 "senderFault": true
1145 },
1146 "exception": true,
1147 "retryable": {
1148 "throttling": true
1149 }
1150 },
1151 "ValidationException": {
1152 "type": "structure",
1153 "required": [
1154 "message"
1155 ],
1156 "members": {
1157 "message": {
1158 "shape": "String"
1159 }
1160 },
1161 "error": {
1162 "httpStatusCode": 400,
1163 "senderFault": true
1164 },
1165 "exception": true
1166 }
1167 },
1168 "documentation": "<p>Launch with AWS API surface for the AWS MCP Server and AWS Agent Toolkit. Uses Bearer auth (BuilderID PKCE flow) for CLI/IDE plugin callers.</p>"