Apply one exact ready design to the Project delivery plan

POST/v1/projects/{projectId}/delivery-design/apply

Copies the exact current ready contract into the separately governed delivery-plan boundary. It does not provision resources or start execution.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
NameLocationTypeRequiredDescription
projectIdpathstringYesProject ID
Query parameters
None.
Header parameters
NameLocationTypeRequiredDescription
Idempotency-KeyheaderstringNo—

Body schema

Content type: application/json · Optional

FieldTypeRequiredDescription
designFingerprintstringNo—
idempotencyKeystringNo—

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Exact design contract applied without provisioning or executionapplication/json
FieldTypeRequiredDescription
deliveryDesignobjectYes—
deliveryDesign.idstringYesUnique identifier.
deliveryDesign.projectIdstringYesProject ID.
deliveryDesign.userIdstringNoUser ID.
deliveryDesign.organizationIdstringNo—
deliveryDesign.createdByUserIdstringNo—
deliveryDesign.revisionintegerYes—
deliveryDesign.statusneeds_input | ready | archivedYesCurrent lifecycle status.
deliveryDesign.requestFingerprintstringYes—
deliveryDesign.designFingerprintstringYes—
deliveryDesign.requestobjectYes—
deliveryDesign.request.schemaVersioncomputer_agents_project_delivery_design_request_v1No—
deliveryDesign.request.briefobjectYes—
deliveryDesign.request.brief.namestringNoHuman-readable name.
deliveryDesign.request.brief.goalstringYes—
deliveryDesign.request.brief.contextstringNo—
deliveryDesign.request.brief.constraintsstring[]No—
deliveryDesign.request.brief.expectedOutputsstring[]No—
deliveryDesign.request.brief.workflowKindauto | agent | scheduled_pipeline | event_driven_pipeline | service_topologyNo—
deliveryDesign.request.brief.schedulestringNo—
deliveryDesign.request.validationAssetsobject[]No—
deliveryDesign.request.validationAssets[].idstringYesUnique identifier.
deliveryDesign.request.validationAssets[].namestringYesHuman-readable name.
deliveryDesign.request.validationAssets[].uristringYes—
deliveryDesign.request.validationAssets[].kindvalidation_set | training_set | specification | source_document | otherYes—
deliveryDesign.request.validationAssets[].sha256stringNo—
deliveryDesign.request.capabilitiesobjectNo—
deliveryDesign.request.capabilities.managedFunctionbooleanNo—
deliveryDesign.request.capabilities.managedWorkflowbooleanNo—
deliveryDesign.request.capabilities.persistResultsbooleanNo—
deliveryDesign.request.capabilities.requiredSecretKeysstring[]No—
deliveryDesign.request.topologyobjectNoOptional authoritative topology of already-existing platform resources. When populated, every resource is bound with the existing lifecycle and no managed Function or Metronome replacement is inferred.
deliveryDesign.request.topology.resourcesobject[]No—
deliveryDesign.request.topology.resources[].keystringYes—
deliveryDesign.request.topology.resources[].kindfunctionYes—
deliveryDesign.request.topology.resources[].resourceIdstringYes—
deliveryDesign.request.topology.resources[].versionIdstringYes—
deliveryDesign.request.topology.resources[].deploymentRevisionstringYes—
deliveryDesign.request.topology.resources[].namestringYesHuman-readable name.
deliveryDesign.request.topology.resources[].descriptionstringNoHuman-readable description.
deliveryDesign.request.topology.resources[].runtimenodejs22 | python312No—
deliveryDesign.request.topology.resources[].regionstringNo—
deliveryDesign.request.topology.resources[].authModepublic | privateNo—
deliveryDesign.request.topology.connectionsobject[]No—
deliveryDesign.request.topology.connections[].idstringYesUnique identifier.
deliveryDesign.request.topology.connections[].sourcestringYes—
deliveryDesign.request.topology.connections[].targetstringYes—
deliveryDesign.request.topology.connections[].typedepends_on | invokes | triggers | reads | writes | uses_secrets | runs_inYes—
deliveryDesign.request.topology.connections[].metadataobjectNoFree-form metadata object.
deliveryDesign.request.topology.entrypointResourceKeystringNo—
deliveryDesign.request.topology.evaluationResourceKeysstring[]NoExact Agent, Function, and Metronome resource closure executed by Evaluation. The complete authoritative topology remains bound and verified by Build and Test. An empty array preserves the legacy behavior of evaluating every executable resource.
deliveryDesign.request.topology.entrypointInvocationobjectNoExact invocation contract used when Evaluation targets the existing topology entrypoint.
deliveryDesign.request.topology.entrypointInvocation.methodGET | POST | PUT | PATCH | DELETENo—
deliveryDesign.request.topology.entrypointInvocation.pathstringNoWorkspace-relative file path.
deliveryDesign.request.topology.entrypointInvocation.timeoutMsintegerNo—
deliveryDesign.request.bindingsobjectNo—
deliveryDesign.request.bindings.executionAgentIdstringNo—
deliveryDesign.request.bindings.targetAgentIdstringNo—
deliveryDesign.request.bindings.fineTunerAgentIdstringNo—
deliveryDesign.request.bindings.reviewerUserIdstringNo—
deliveryDesign.request.testsobjectNo—
deliveryDesign.request.tests.casesobject[]No—
deliveryDesign.request.evaluationobjectNo—
deliveryDesign.request.evaluation.casesobject[]No—
deliveryDesign.request.evaluation.cases[].idstringYesUnique identifier.
deliveryDesign.request.evaluation.cases[].inputstringYes—
deliveryDesign.request.evaluation.cases[].expectedOutputstringYes—
deliveryDesign.request.evaluation.cases[].evaluationGuidancestringYes—
deliveryDesign.request.evaluation.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryDesign.request.evaluation.cases[].metadataobjectNoFree-form metadata object.
deliveryDesign.request.evaluation.sourceobjectNo—
deliveryDesign.request.evaluation.source.typeexisting_evaluation_versionYes—
deliveryDesign.request.evaluation.source.evaluationIdstringYes—
deliveryDesign.request.evaluation.source.versionIdstringYes—
deliveryDesign.request.evaluation.source.datasetAssetIdstringYes—
deliveryDesign.request.evaluation.evaluatorobjectNo—
deliveryDesign.request.evaluation.evaluator.typeexactYes—
deliveryDesign.request.evaluation.passThresholdnumberNo—
deliveryDesign.request.evaluation.datasetGovernanceobjectNo—
deliveryDesign.request.evaluation.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryDesign.request.evaluation.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.request.evaluation.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.request.evaluation.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.request.evaluation.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryDesign.request.evaluation.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryDesign.request.evaluation.datasetGovernance.lockedAtstringYes—
deliveryDesign.request.evaluation.workflowAcceptanceSourceobjectNo—
deliveryDesign.request.evaluation.workflowAcceptanceSource.typeexisting_evaluation_versionYes—
deliveryDesign.request.evaluation.workflowAcceptanceSource.evaluationIdstringYes—
deliveryDesign.request.evaluation.workflowAcceptanceSource.versionIdstringYes—
deliveryDesign.request.evaluation.workflowAcceptanceSource.datasetAssetIdstringYes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernanceobjectNo—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.annotationGuidelineVersionstringYes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.adjudicationRecordSha256stringYes—
deliveryDesign.request.evaluation.workflowAcceptanceDatasetGovernance.lockedAtstringYes—
deliveryDesign.request.controlsobjectNo—
deliveryDesign.request.controls.modeassisted | autonomousNo—
deliveryDesign.request.controls.optimizationEnabledbooleanNo—
deliveryDesign.request.controls.maximumOptimizationIterationsintegerNo—
deliveryDesign.request.controls.guardrailPoliciesobject[]No—
deliveryDesign.request.controls.assuranceApprovalModenone | manualNo—
deliveryDesign.request.controls.repairEnabledbooleanNo—
deliveryDesign.request.controls.maximumRepairAttemptsintegerNo—
deliveryDesign.request.acceptanceobjectNo—
deliveryDesign.request.acceptance.minimumAverageScorenumberNo—
deliveryDesign.request.acceptance.minimumPassRatenumberNo—
deliveryDesign.request.acceptance.requireAllTestsPassingtrueNo—
deliveryDesign.request.acceptance.requirePublishedOptimizationCandidatebooleanNo—
deliveryDesign.request.budgetobjectNo—
deliveryDesign.request.budget.maximumTotalCostUsdnumberNo—
deliveryDesign.designobjectYes—
deliveryDesign.design.schemaVersioncomputer_agents_project_delivery_design_v1Yes—
deliveryDesign.design.requestFingerprintstringYes—
deliveryDesign.design.designFingerprintstringYes—
deliveryDesign.design.readinessready | needs_inputYes—
deliveryDesign.design.archetypeagent | scheduled_pipeline | event_driven_pipeline | service_topologyYes—
deliveryDesign.design.missingInputsobject[]Yes—
deliveryDesign.design.missingInputs[].codestringYes—
deliveryDesign.design.missingInputs[].pathstringYesWorkspace-relative file path.
deliveryDesign.design.missingInputs[].messagestringYesMessage text.
deliveryDesign.design.missingInputs[].blockingtrueYes—
deliveryDesign.design.assumptionsstring[]Yes—
deliveryDesign.design.proposedTopologyobjectYes—
deliveryDesign.design.proposedTopology.resourcesobject[]Yes—
deliveryDesign.design.proposedTopology.connectionsobject[]Yes—
deliveryDesign.design.contractobjectYes—
deliveryDesign.design.contract.schemaVersioncomputer_agents_project_delivery_contract_v4No—
deliveryDesign.design.contract.modeassisted | autonomousNo—
deliveryDesign.design.contract.goalstringYes—
deliveryDesign.design.contract.validationAssetsobject[]No—
deliveryDesign.design.contract.validationAssets[].idstringYesUnique identifier.
deliveryDesign.design.contract.validationAssets[].namestringYesHuman-readable name.
deliveryDesign.design.contract.validationAssets[].uristringYes—
deliveryDesign.design.contract.validationAssets[].kindvalidation_set | training_set | specification | source_document | otherYes—
deliveryDesign.design.contract.validationAssets[].sha256stringNo—
deliveryDesign.design.contract.agentsobjectYes—
deliveryDesign.design.contract.agents.executionAgentIdstringNo—
deliveryDesign.design.contract.agents.targetAgentIdstringYes—
deliveryDesign.design.contract.agents.fineTunerAgentIdstringNo—
deliveryDesign.design.contract.agents.reviewerUserIdstringNo—
deliveryDesign.design.contract.topologyobjectYes—
deliveryDesign.design.contract.topology.resourcesobject[]Yes—
deliveryDesign.design.contract.topology.resources[].keystringYes—
deliveryDesign.design.contract.topology.resources[].kindfunctionYes—
deliveryDesign.design.contract.topology.resources[].lifecyclemanaged | existingNo—
deliveryDesign.design.contract.topology.resources[].resourceIdstringNo—
deliveryDesign.design.contract.topology.resources[].versionIdstringNo—
deliveryDesign.design.contract.topology.resources[].deploymentRevisionstringNo—
deliveryDesign.design.contract.topology.resources[].namestringYesHuman-readable name.
deliveryDesign.design.contract.topology.resources[].descriptionstringNoHuman-readable description.
deliveryDesign.design.contract.topology.resources[].runtimenodejs22 | python312No—
deliveryDesign.design.contract.topology.resources[].regionstringNo—
deliveryDesign.design.contract.topology.resources[].authModepublic | privateNo—
deliveryDesign.design.contract.topology.resources[].sourcePathstringNoWorkspace-relative file path.
deliveryDesign.design.contract.topology.connectionsobject[]Yes—
deliveryDesign.design.contract.topology.connections[].idstringYesUnique identifier.
deliveryDesign.design.contract.topology.connections[].sourcestringYes—
deliveryDesign.design.contract.topology.connections[].targetstringYes—
deliveryDesign.design.contract.topology.connections[].typedepends_on | invokes | triggers | reads | writes | uses_secrets | runs_in | uses_mcpYes—
deliveryDesign.design.contract.topology.connections[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.contract.servicesobjectYes—
deliveryDesign.design.contract.services.testsobjectYes—
deliveryDesign.design.contract.services.tests.enabledtrueNo—
deliveryDesign.design.contract.services.tests.namestringYesHuman-readable name.
deliveryDesign.design.contract.services.tests.descriptionstringNoHuman-readable description.
deliveryDesign.design.contract.services.tests.definitionobjectYes—
deliveryDesign.design.contract.services.tests.definition.schemaVersioncomputer_agents_test_plan_v1Yes—
deliveryDesign.design.contract.services.tests.definition.casesobject[]Yes—
deliveryDesign.design.contract.services.tests.definition.cases[].idstringYesUnique identifier.
deliveryDesign.design.contract.services.tests.definition.cases[].namestringYesHuman-readable name.
deliveryDesign.design.contract.services.tests.definition.cases[].descriptionstringYesHuman-readable description.
deliveryDesign.design.contract.services.tests.definition.cases[].kindcommand | contract | integration | browser | agent | security | customYes—
deliveryDesign.design.contract.services.tests.definition.cases[].commandstringYes—
deliveryDesign.design.contract.services.tests.definition.cases[].workingDirectorystringYes—
deliveryDesign.design.contract.services.tests.definition.cases[].timeoutMsintegerYes—
deliveryDesign.design.contract.services.tests.definition.cases[].retriesintegerYes—
deliveryDesign.design.contract.services.tests.definition.cases[].envobjectYes—
deliveryDesign.design.contract.services.tests.definition.cases[].secretRefsstring[]Yes—
deliveryDesign.design.contract.services.tests.definition.cases[].requestobjectYesKind-specific structured request. Secrets must be referenced through `secretRefs`.
deliveryDesign.design.contract.services.tests.definition.cases[].assertionsobject[]Yes—
deliveryDesign.design.contract.services.tests.definition.cases[].agentIdstringYesAgent ID.
deliveryDesign.design.contract.services.tests.definition.cases[].enabledbooleanYes—
deliveryDesign.design.contract.services.tests.definition.cases[].tagsstring[]Yes—
deliveryDesign.design.contract.services.tests.definition.concurrencyintegerYes—
deliveryDesign.design.contract.services.tests.definition.stopOnFailurebooleanYes—
deliveryDesign.design.contract.services.tests.definition.retryPolicyobjectYes—
deliveryDesign.design.contract.services.tests.definition.retryPolicy.maxAttemptsintegerYes—
deliveryDesign.design.contract.services.tests.definition.evidencePolicyobjectYes—
deliveryDesign.design.contract.services.tests.definition.evidencePolicy.retainLogsbooleanYes—
deliveryDesign.design.contract.services.tests.definition.evidencePolicy.retainScreenshotsbooleanYes—
deliveryDesign.design.contract.services.tests.definition.evidencePolicy.retainTracesbooleanYes—
deliveryDesign.design.contract.services.tests.definition.evidencePolicy.retainArtifactsbooleanYes—
deliveryDesign.design.contract.services.tests.definition.evidencePolicy.redactSecretsbooleanYes—
deliveryDesign.design.contract.services.evaluationobjectYes—
deliveryDesign.design.contract.services.evaluation.enabledtrueNo—
deliveryDesign.design.contract.services.evaluation.namestringYesHuman-readable name.
deliveryDesign.design.contract.services.evaluation.descriptionstringNoHuman-readable description.
deliveryDesign.design.contract.services.evaluation.casesobject[]No—
deliveryDesign.design.contract.services.evaluation.cases[].idstringYesUnique identifier.
deliveryDesign.design.contract.services.evaluation.cases[].inputstringYes—
deliveryDesign.design.contract.services.evaluation.cases[].expectedOutputstringYes—
deliveryDesign.design.contract.services.evaluation.cases[].evaluationGuidancestringYes—
deliveryDesign.design.contract.services.evaluation.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryDesign.design.contract.services.evaluation.cases[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.contract.services.evaluation.sourceobjectNo—
deliveryDesign.design.contract.services.evaluation.source.typeexisting_evaluation_versionYes—
deliveryDesign.design.contract.services.evaluation.source.evaluationIdstringYes—
deliveryDesign.design.contract.services.evaluation.source.versionIdstringYes—
deliveryDesign.design.contract.services.evaluation.source.datasetAssetIdstringYes—
deliveryDesign.design.contract.services.evaluation.targetobjectNo—
deliveryDesign.design.contract.services.evaluation.target.kindagentYes—
deliveryDesign.design.contract.services.evaluation.target.agentIdstringNoAgent ID.
deliveryDesign.design.contract.services.evaluation.evaluatorobjectNo—
deliveryDesign.design.contract.services.evaluation.evaluator.typeexactYes—
deliveryDesign.design.contract.services.evaluation.passThresholdnumberNo—
deliveryDesign.design.contract.services.evaluation.datasetGovernanceobjectYes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryDesign.design.contract.services.evaluation.datasetGovernance.lockedAtstringYes—
deliveryDesign.design.contract.services.workflowAcceptanceobjectNo—
deliveryDesign.design.contract.services.workflowAcceptance.enabledtrueNo—
deliveryDesign.design.contract.services.workflowAcceptance.namestringYesHuman-readable name.
deliveryDesign.design.contract.services.workflowAcceptance.descriptionstringNoHuman-readable description.
deliveryDesign.design.contract.services.workflowAcceptance.casesobject[]No—
deliveryDesign.design.contract.services.workflowAcceptance.cases[].idstringYesUnique identifier.
deliveryDesign.design.contract.services.workflowAcceptance.cases[].inputstringYes—
deliveryDesign.design.contract.services.workflowAcceptance.cases[].expectedOutputstringYes—
deliveryDesign.design.contract.services.workflowAcceptance.cases[].evaluationGuidancestringYes—
deliveryDesign.design.contract.services.workflowAcceptance.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryDesign.design.contract.services.workflowAcceptance.cases[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.contract.services.workflowAcceptance.sourceobjectNo—
deliveryDesign.design.contract.services.workflowAcceptance.source.typeexisting_evaluation_versionYes—
deliveryDesign.design.contract.services.workflowAcceptance.source.evaluationIdstringYes—
deliveryDesign.design.contract.services.workflowAcceptance.source.versionIdstringYes—
deliveryDesign.design.contract.services.workflowAcceptance.source.datasetAssetIdstringYes—
deliveryDesign.design.contract.services.workflowAcceptance.targetobjectNo—
deliveryDesign.design.contract.services.workflowAcceptance.target.kindagentYes—
deliveryDesign.design.contract.services.workflowAcceptance.target.agentIdstringNoAgent ID.
deliveryDesign.design.contract.services.workflowAcceptance.evaluatorobjectNo—
deliveryDesign.design.contract.services.workflowAcceptance.evaluator.typeexactYes—
deliveryDesign.design.contract.services.workflowAcceptance.passThresholdnumberNo—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernanceobjectYes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryDesign.design.contract.services.workflowAcceptance.datasetGovernance.lockedAtstringYes—
deliveryDesign.design.contract.services.optimizationobjectYes—
deliveryDesign.design.contract.services.optimization.enabledbooleanNo—
deliveryDesign.design.contract.services.optimization.namestringYesHuman-readable name.
deliveryDesign.design.contract.services.optimization.instructionsstringYes—
deliveryDesign.design.contract.services.optimization.maximumIterationsintegerNo—
deliveryDesign.design.contract.services.optimization.minimumImprovementnumberNo—
deliveryDesign.design.contract.services.optimization.maximumRegressionnumberNo—
deliveryDesign.design.contract.services.optimization.minimumPairedCasesintegerNo—
deliveryDesign.design.contract.services.optimization.minimumPairedCoveragenumberNo—
deliveryDesign.design.contract.services.optimization.maximumDurationMinutesintegerNo—
deliveryDesign.design.contract.services.optimization.maximumTransientRetriesintegerNo—
deliveryDesign.design.contract.services.optimization.plateauIterationsintegerNo—
deliveryDesign.design.contract.services.optimization.publicationModemanual | auto_on_targetNo—
deliveryDesign.design.contract.services.optimization.publishBestOnLimitbooleanNo—
deliveryDesign.design.contract.services.assuranceobjectYes—
deliveryDesign.design.contract.services.assurance.enabledtrueNo—
deliveryDesign.design.contract.services.assurance.namestringYesHuman-readable name.
deliveryDesign.design.contract.services.assurance.descriptionstringNoHuman-readable description.
deliveryDesign.design.contract.services.assurance.approvalModenone | manualNo—
deliveryDesign.design.contract.services.assurance.maximumEvidenceAgeHoursnumberNo—
deliveryDesign.design.contract.services.guardrailsobjectNo—
deliveryDesign.design.contract.services.guardrails.enabledbooleanNo—
deliveryDesign.design.contract.services.guardrails.policiesobject[]No—
deliveryDesign.design.contract.services.guardrails.policies[].idstringYesUnique identifier.
deliveryDesign.design.contract.services.guardrails.policies[].namestringYesHuman-readable name.
deliveryDesign.design.contract.services.guardrails.policies[].descriptionstringNoHuman-readable description.
deliveryDesign.design.contract.services.guardrails.policies[].promptsobject[]Yes—
deliveryDesign.design.contract.services.guardrails.policies[].prompts[].idstringNoUnique identifier.
deliveryDesign.design.contract.services.guardrails.policies[].prompts[].titlestringYesDisplay title.
deliveryDesign.design.contract.services.guardrails.policies[].prompts[].promptstringYes—
deliveryDesign.design.contract.services.guardrails.policies[].prompts[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.contract.services.guardrails.policies[].policyobjectYes—
deliveryDesign.design.contract.services.guardrails.policies[].policy.schemaVersioncomputer_agents_guardrail_policy_v1Yes—
deliveryDesign.design.contract.services.guardrails.policies[].policy.rulesobject[]Yes—
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].idstringYesUnique identifier.
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].matchobjectYes—
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].outcomeask | denyYesGuardrails are restriction-only and cannot grant access.
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].minimumRing1 | 2 | 3No—
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].severityinfo | warning | high | criticalYes—
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].recommendedControldeny_effect | park | pause | cancel | quarantineYes—
deliveryDesign.design.contract.services.guardrails.policies[].policy.rules[].obligationshuman_approval | security_review | redact_output | verify_target | require_reversible_plan[]Yes—
deliveryDesign.design.contract.services.guardrails.policies[].appliesToexecution_agent | target_agent | fine_tuner_agent[]Yes—
deliveryDesign.design.contract.acceptanceobjectYes—
deliveryDesign.design.contract.acceptance.minimumAverageScorenumberYes—
deliveryDesign.design.contract.acceptance.minimumPassRatenumberYes—
deliveryDesign.design.contract.acceptance.requireAllTestsPassingtrueNo—
deliveryDesign.design.contract.acceptance.requirePublishedOptimizationCandidatebooleanNo—
deliveryDesign.design.contract.budgetobjectYes—
deliveryDesign.design.contract.budget.maximumTotalCostUsdnumberYes—
deliveryDesign.design.contract.repairPolicyobjectNoOptional bounded repair policy. Only trusted failed Test evidence or fully verified completed Evaluation evidence that missed a configured quality threshold can trigger repair. Pinned gates are rerun and a target-scoped changed resource revision is mandatory.
deliveryDesign.design.contract.repairPolicy.enabledbooleanNo—
deliveryDesign.design.contract.repairPolicy.maximumAttemptsintegerNo—
deliveryDesign.design.contract.repairPolicy.repairableStagestest | evaluate | acceptance_evaluate[]No—
deliveryDesign.design.contract.repairPolicy.requireChangedResourceRevisiontrueNo—
deliveryDesign.design.previewobjectYes—
deliveryDesign.design.preview.schemaVersioncomputer_agents_project_delivery_preview_v1Yes—
deliveryDesign.design.preview.contractSchemaVersioncomputer_agents_project_delivery_contract_v4Yes—
deliveryDesign.design.preview.contractFingerprintstringYes—
deliveryDesign.design.preview.contractobjectYes—
deliveryDesign.design.preview.contract.schemaVersioncomputer_agents_project_delivery_contract_v4No—
deliveryDesign.design.preview.contract.modeassisted | autonomousNo—
deliveryDesign.design.preview.contract.goalstringYes—
deliveryDesign.design.preview.contract.validationAssetsobject[]No—
deliveryDesign.design.preview.contract.validationAssets[].idstringYesUnique identifier.
deliveryDesign.design.preview.contract.validationAssets[].namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.validationAssets[].uristringYes—
deliveryDesign.design.preview.contract.validationAssets[].kindvalidation_set | training_set | specification | source_document | otherYes—
deliveryDesign.design.preview.contract.validationAssets[].sha256stringNo—
deliveryDesign.design.preview.contract.agentsobjectYes—
deliveryDesign.design.preview.contract.agents.executionAgentIdstringNo—
deliveryDesign.design.preview.contract.agents.targetAgentIdstringYes—
deliveryDesign.design.preview.contract.agents.fineTunerAgentIdstringNo—
deliveryDesign.design.preview.contract.agents.reviewerUserIdstringNo—
deliveryDesign.design.preview.contract.topologyobjectYes—
deliveryDesign.design.preview.contract.topology.resourcesobject[]Yes—
deliveryDesign.design.preview.contract.topology.resources[].keystringYes—
deliveryDesign.design.preview.contract.topology.resources[].kindfunctionYes—
deliveryDesign.design.preview.contract.topology.resources[].lifecyclemanaged | existingNo—
deliveryDesign.design.preview.contract.topology.resources[].resourceIdstringNo—
deliveryDesign.design.preview.contract.topology.resources[].versionIdstringNo—
deliveryDesign.design.preview.contract.topology.resources[].deploymentRevisionstringNo—
deliveryDesign.design.preview.contract.topology.resources[].namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.topology.resources[].descriptionstringNoHuman-readable description.
deliveryDesign.design.preview.contract.topology.resources[].runtimenodejs22 | python312No—
deliveryDesign.design.preview.contract.topology.resources[].regionstringNo—
deliveryDesign.design.preview.contract.topology.resources[].authModepublic | privateNo—
deliveryDesign.design.preview.contract.topology.resources[].sourcePathstringNoWorkspace-relative file path.
deliveryDesign.design.preview.contract.topology.connectionsobject[]Yes—
deliveryDesign.design.preview.contract.topology.connections[].idstringYesUnique identifier.
deliveryDesign.design.preview.contract.topology.connections[].sourcestringYes—
deliveryDesign.design.preview.contract.topology.connections[].targetstringYes—
deliveryDesign.design.preview.contract.topology.connections[].typedepends_on | invokes | triggers | reads | writes | uses_secrets | runs_in | uses_mcpYes—
deliveryDesign.design.preview.contract.topology.connections[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.preview.contract.servicesobjectYes—
deliveryDesign.design.preview.contract.services.testsobjectYes—
deliveryDesign.design.preview.contract.services.tests.enabledtrueNo—
deliveryDesign.design.preview.contract.services.tests.namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.tests.descriptionstringNoHuman-readable description.
deliveryDesign.design.preview.contract.services.tests.definitionobjectYes—
deliveryDesign.design.preview.contract.services.tests.definition.schemaVersioncomputer_agents_test_plan_v1Yes—
deliveryDesign.design.preview.contract.services.tests.definition.casesobject[]Yes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].idstringYesUnique identifier.
deliveryDesign.design.preview.contract.services.tests.definition.cases[].namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.tests.definition.cases[].descriptionstringYesHuman-readable description.
deliveryDesign.design.preview.contract.services.tests.definition.cases[].kindcommand | contract | integration | browser | agent | security | customYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].commandstringYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].workingDirectorystringYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].timeoutMsintegerYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].retriesintegerYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].envobjectYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].secretRefsstring[]Yes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].requestobjectYesKind-specific structured request. Secrets must be referenced through `secretRefs`.
deliveryDesign.design.preview.contract.services.tests.definition.cases[].assertionsobject[]Yes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].agentIdstringYesAgent ID.
deliveryDesign.design.preview.contract.services.tests.definition.cases[].enabledbooleanYes—
deliveryDesign.design.preview.contract.services.tests.definition.cases[].tagsstring[]Yes—
deliveryDesign.design.preview.contract.services.tests.definition.concurrencyintegerYes—
deliveryDesign.design.preview.contract.services.tests.definition.stopOnFailurebooleanYes—
deliveryDesign.design.preview.contract.services.tests.definition.retryPolicyobjectYes—
deliveryDesign.design.preview.contract.services.tests.definition.retryPolicy.maxAttemptsintegerYes—
deliveryDesign.design.preview.contract.services.tests.definition.evidencePolicyobjectYes—
deliveryDesign.design.preview.contract.services.tests.definition.evidencePolicy.retainLogsbooleanYes—
deliveryDesign.design.preview.contract.services.tests.definition.evidencePolicy.retainScreenshotsbooleanYes—
deliveryDesign.design.preview.contract.services.tests.definition.evidencePolicy.retainTracesbooleanYes—
deliveryDesign.design.preview.contract.services.tests.definition.evidencePolicy.retainArtifactsbooleanYes—
deliveryDesign.design.preview.contract.services.tests.definition.evidencePolicy.redactSecretsbooleanYes—
deliveryDesign.design.preview.contract.services.evaluationobjectYes—
deliveryDesign.design.preview.contract.services.evaluation.enabledtrueNo—
deliveryDesign.design.preview.contract.services.evaluation.namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.evaluation.descriptionstringNoHuman-readable description.
deliveryDesign.design.preview.contract.services.evaluation.casesobject[]No—
deliveryDesign.design.preview.contract.services.evaluation.cases[].idstringYesUnique identifier.
deliveryDesign.design.preview.contract.services.evaluation.cases[].inputstringYes—
deliveryDesign.design.preview.contract.services.evaluation.cases[].expectedOutputstringYes—
deliveryDesign.design.preview.contract.services.evaluation.cases[].evaluationGuidancestringYes—
deliveryDesign.design.preview.contract.services.evaluation.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryDesign.design.preview.contract.services.evaluation.cases[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.preview.contract.services.evaluation.sourceobjectNo—
deliveryDesign.design.preview.contract.services.evaluation.source.typeexisting_evaluation_versionYes—
deliveryDesign.design.preview.contract.services.evaluation.source.evaluationIdstringYes—
deliveryDesign.design.preview.contract.services.evaluation.source.versionIdstringYes—
deliveryDesign.design.preview.contract.services.evaluation.source.datasetAssetIdstringYes—
deliveryDesign.design.preview.contract.services.evaluation.targetobjectNo—
deliveryDesign.design.preview.contract.services.evaluation.target.kindagentYes—
deliveryDesign.design.preview.contract.services.evaluation.target.agentIdstringNoAgent ID.
deliveryDesign.design.preview.contract.services.evaluation.evaluatorobjectNo—
deliveryDesign.design.preview.contract.services.evaluation.evaluator.typeexactYes—
deliveryDesign.design.preview.contract.services.evaluation.passThresholdnumberNo—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernanceobjectYes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryDesign.design.preview.contract.services.evaluation.datasetGovernance.lockedAtstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptanceobjectNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.enabledtrueNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.workflowAcceptance.descriptionstringNoHuman-readable description.
deliveryDesign.design.preview.contract.services.workflowAcceptance.casesobject[]No—
deliveryDesign.design.preview.contract.services.workflowAcceptance.cases[].idstringYesUnique identifier.
deliveryDesign.design.preview.contract.services.workflowAcceptance.cases[].inputstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.cases[].expectedOutputstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.cases[].evaluationGuidancestringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.cases[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.preview.contract.services.workflowAcceptance.sourceobjectNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.source.typeexisting_evaluation_versionYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.source.evaluationIdstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.source.versionIdstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.source.datasetAssetIdstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.targetobjectNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.target.kindagentYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.target.agentIdstringNoAgent ID.
deliveryDesign.design.preview.contract.services.workflowAcceptance.evaluatorobjectNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.evaluator.typeexactYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.passThresholdnumberNo—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernanceobjectYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryDesign.design.preview.contract.services.workflowAcceptance.datasetGovernance.lockedAtstringYes—
deliveryDesign.design.preview.contract.services.optimizationobjectYes—
deliveryDesign.design.preview.contract.services.optimization.enabledbooleanNo—
deliveryDesign.design.preview.contract.services.optimization.namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.optimization.instructionsstringYes—
deliveryDesign.design.preview.contract.services.optimization.maximumIterationsintegerNo—
deliveryDesign.design.preview.contract.services.optimization.minimumImprovementnumberNo—
deliveryDesign.design.preview.contract.services.optimization.maximumRegressionnumberNo—
deliveryDesign.design.preview.contract.services.optimization.minimumPairedCasesintegerNo—
deliveryDesign.design.preview.contract.services.optimization.minimumPairedCoveragenumberNo—
deliveryDesign.design.preview.contract.services.optimization.maximumDurationMinutesintegerNo—
deliveryDesign.design.preview.contract.services.optimization.maximumTransientRetriesintegerNo—
deliveryDesign.design.preview.contract.services.optimization.plateauIterationsintegerNo—
deliveryDesign.design.preview.contract.services.optimization.publicationModemanual | auto_on_targetNo—
deliveryDesign.design.preview.contract.services.optimization.publishBestOnLimitbooleanNo—
deliveryDesign.design.preview.contract.services.assuranceobjectYes—
deliveryDesign.design.preview.contract.services.assurance.enabledtrueNo—
deliveryDesign.design.preview.contract.services.assurance.namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.assurance.descriptionstringNoHuman-readable description.
deliveryDesign.design.preview.contract.services.assurance.approvalModenone | manualNo—
deliveryDesign.design.preview.contract.services.assurance.maximumEvidenceAgeHoursnumberNo—
deliveryDesign.design.preview.contract.services.guardrailsobjectNo—
deliveryDesign.design.preview.contract.services.guardrails.enabledbooleanNo—
deliveryDesign.design.preview.contract.services.guardrails.policiesobject[]No—
deliveryDesign.design.preview.contract.services.guardrails.policies[].idstringYesUnique identifier.
deliveryDesign.design.preview.contract.services.guardrails.policies[].namestringYesHuman-readable name.
deliveryDesign.design.preview.contract.services.guardrails.policies[].descriptionstringNoHuman-readable description.
deliveryDesign.design.preview.contract.services.guardrails.policies[].promptsobject[]Yes—
deliveryDesign.design.preview.contract.services.guardrails.policies[].prompts[].idstringNoUnique identifier.
deliveryDesign.design.preview.contract.services.guardrails.policies[].prompts[].titlestringYesDisplay title.
deliveryDesign.design.preview.contract.services.guardrails.policies[].prompts[].promptstringYes—
deliveryDesign.design.preview.contract.services.guardrails.policies[].prompts[].metadataobjectNoFree-form metadata object.
deliveryDesign.design.preview.contract.services.guardrails.policies[].policyobjectYes—
deliveryDesign.design.preview.contract.services.guardrails.policies[].policy.schemaVersioncomputer_agents_guardrail_policy_v1Yes—
deliveryDesign.design.preview.contract.services.guardrails.policies[].policy.rulesobject[]Yes—
deliveryDesign.design.preview.contract.services.guardrails.policies[].appliesToexecution_agent | target_agent | fine_tuner_agent[]Yes—
deliveryDesign.design.preview.contract.acceptanceobjectYes—
deliveryDesign.design.preview.contract.acceptance.minimumAverageScorenumberYes—
deliveryDesign.design.preview.contract.acceptance.minimumPassRatenumberYes—
deliveryDesign.design.preview.contract.acceptance.requireAllTestsPassingtrueNo—
deliveryDesign.design.preview.contract.acceptance.requirePublishedOptimizationCandidatebooleanNo—
deliveryDesign.design.preview.contract.budgetobjectYes—
deliveryDesign.design.preview.contract.budget.maximumTotalCostUsdnumberYes—
deliveryDesign.design.preview.contract.repairPolicyobjectNoOptional bounded repair policy. Only trusted failed Test evidence or fully verified completed Evaluation evidence that missed a configured quality threshold can trigger repair. Pinned gates are rerun and a target-scoped changed resource revision is mandatory.
deliveryDesign.design.preview.contract.repairPolicy.enabledbooleanNo—
deliveryDesign.design.preview.contract.repairPolicy.maximumAttemptsintegerNo—
deliveryDesign.design.preview.contract.repairPolicy.repairableStagestest | evaluate | acceptance_evaluate[]No—
deliveryDesign.design.preview.contract.repairPolicy.requireChangedResourceRevisiontrueNo—
deliveryDesign.design.preview.graphobjectYes—
deliveryDesign.design.preview.graph.schemaVersioncomputer_agents_project_delivery_graph_v1 | computer_agents_project_delivery_graph_v2Yes—
deliveryDesign.design.preview.graph.contractFingerprintstringYes—
deliveryDesign.design.preview.graph.nodesobject[]Yes—
deliveryDesign.design.preview.graph.nodes[].idbuild | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliverYesUnique identifier.
deliveryDesign.design.preview.graph.nodes[].titlestringYesDisplay title.
deliveryDesign.design.preview.graph.nodes[].stateplanned | blocked | skippedYes—
deliveryDesign.design.preview.graph.nodes[].dependsOnbuild | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[]Yes—
deliveryDesign.design.preview.graph.nodes[].resourceTypesstring[]Yes—
deliveryDesign.design.preview.graph.nodes[].taskIdstringNo—
deliveryDesign.design.preview.graph.nodes[].resourceIdsstring[]No—
deliveryDesign.design.preview.graph.edgesobject[]Yes—
deliveryDesign.design.preview.graph.edges[].sourcestringYes—
deliveryDesign.design.preview.graph.edges[].targetstringYes—
deliveryDesign.design.preview.intentobjectYes—
deliveryDesign.design.preview.intent.modeassisted | autonomousYes—
deliveryDesign.design.preview.intent.goalstringYes—
deliveryDesign.design.preview.validationAssetsobjectYes—
deliveryDesign.design.preview.validationAssets.totalintegerYes—
deliveryDesign.design.preview.validationAssets.digestBoundintegerYes—
deliveryDesign.design.preview.validationAssets.byKindobjectYes—
deliveryDesign.design.preview.validationAssets.byKind.validation_setintegerYes—
deliveryDesign.design.preview.validationAssets.byKind.training_setintegerYes—
deliveryDesign.design.preview.validationAssets.byKind.specificationintegerYes—
deliveryDesign.design.preview.validationAssets.byKind.source_documentintegerYes—
deliveryDesign.design.preview.validationAssets.byKind.otherintegerYes—
deliveryDesign.design.preview.topologyobjectYes—
deliveryDesign.design.preview.topology.resourceCountintegerYes—
deliveryDesign.design.preview.topology.connectionCountintegerYes—
deliveryDesign.design.preview.topology.managedResourceCountintegerYes—
deliveryDesign.design.preview.topology.existingResourceCountintegerYes—
deliveryDesign.design.preview.topology.resourceKindsobjectYes—
deliveryDesign.design.preview.topology.resourcesobject[]Yes—
deliveryDesign.design.preview.topology.resources[].keystringYes—
deliveryDesign.design.preview.topology.resources[].kindfunction | metronome | database | secrets | agent | environment | mcp_server | source_assetYes—
deliveryDesign.design.preview.topology.resources[].lifecyclemanaged | existingYes—
deliveryDesign.design.preview.topology.resources[].namestringYesHuman-readable name.
deliveryDesign.design.preview.topology.resources[].resourceIdstringYes—
deliveryDesign.design.preview.stagesobjectYes—
deliveryDesign.design.preview.stages.activebuild | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[]Yes—
deliveryDesign.design.preview.stages.skippedbuild | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[]Yes—
deliveryDesign.design.preview.servicesobjectYes—
deliveryDesign.design.preview.services.testsobjectYes—
deliveryDesign.design.preview.services.tests.caseCountintegerYes—
deliveryDesign.design.preview.services.tests.caseKindsstring[]Yes—
deliveryDesign.design.preview.services.componentEvaluationobjectYes—
deliveryDesign.design.preview.services.componentEvaluation.sourceinline | existing_evaluation_versionYes—
deliveryDesign.design.preview.services.componentEvaluation.caseCountintegerYes—
deliveryDesign.design.preview.services.componentEvaluation.targetKindagent | function | metronome | service_topologyYes—
deliveryDesign.design.preview.services.componentEvaluation.evaluatorTypeexact | agent | deterministicYes—
deliveryDesign.design.preview.services.componentEvaluation.passThresholdnumberYes—
deliveryDesign.design.preview.services.componentEvaluation.runPurposedevelopment | optimization | releaseYes—
deliveryDesign.design.preview.services.componentEvaluation.datasetMaturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.design.preview.services.componentEvaluation.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.design.preview.services.componentEvaluation.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.design.preview.services.workflowAcceptanceobjectYes—
deliveryDesign.design.preview.services.workflowAcceptance.sourceinline | existing_evaluation_versionYes—
deliveryDesign.design.preview.services.workflowAcceptance.caseCountintegerYes—
deliveryDesign.design.preview.services.workflowAcceptance.targetKindagent | function | metronome | service_topologyYes—
deliveryDesign.design.preview.services.workflowAcceptance.evaluatorTypeexact | agent | deterministicYes—
deliveryDesign.design.preview.services.workflowAcceptance.passThresholdnumberYes—
deliveryDesign.design.preview.services.workflowAcceptance.runPurposedevelopment | optimization | releaseYes—
deliveryDesign.design.preview.services.workflowAcceptance.datasetMaturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryDesign.design.preview.services.workflowAcceptance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryDesign.design.preview.services.workflowAcceptance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryDesign.design.preview.services.optimizationobjectYes—
deliveryDesign.design.preview.services.optimization.enabledbooleanYes—
deliveryDesign.design.preview.services.optimization.maximumIterationsintegerYes—
deliveryDesign.design.preview.services.optimization.publicationModemanual | auto_on_targetYes—
deliveryDesign.design.preview.services.optimization.publishBestOnLimitbooleanYes—
deliveryDesign.design.preview.services.guardrailsobjectYes—
deliveryDesign.design.preview.services.guardrails.enabledbooleanYes—
deliveryDesign.design.preview.services.guardrails.policyCountintegerYes—
deliveryDesign.design.preview.services.guardrails.promptCountintegerYes—
deliveryDesign.design.preview.services.assuranceobjectYes—
deliveryDesign.design.preview.services.assurance.approvalModenone | manualYes—
deliveryDesign.design.preview.services.assurance.maximumEvidenceAgeHoursnumberYes—
deliveryDesign.design.preview.acceptanceobjectYes—
deliveryDesign.design.preview.acceptance.minimumAverageScorenumberYes—
deliveryDesign.design.preview.acceptance.minimumPassRatenumberYes—
deliveryDesign.design.preview.acceptance.requireAllTestsPassingtrueYes—
deliveryDesign.design.preview.acceptance.requirePublishedOptimizationCandidatebooleanYes—
deliveryDesign.design.preview.budgetobjectYes—
deliveryDesign.design.preview.budget.maximumTotalCostUsdnumberYes—
deliveryDesign.design.preview.repairPolicyobjectYes—
deliveryDesign.design.preview.repairPolicy.enabledbooleanYes—
deliveryDesign.design.preview.repairPolicy.maximumAttemptsintegerYes—
deliveryDesign.design.preview.repairPolicy.repairableStagestest | evaluate | acceptance_evaluate[]Yes—
deliveryDesign.design.preview.repairPolicy.requireChangedResourceRevisiontrueYes—
deliveryDesign.idempotencyKeystringNo—
deliveryDesign.createdAtstringYesISO 8601 timestamp.
deliveryDesign.updatedAtstringYesISO 8601 timestamp.
deliveryDesign.eventsobject[]No—
deliveryDesign.events[].idstringYesUnique identifier.
deliveryDesign.events[].typestringYes—
deliveryDesign.events[].actorUserIdstringYes—
deliveryDesign.events[].payloadobjectYes—
deliveryDesign.events[].createdAtstringYesISO 8601 timestamp.
deliveryPlanobjectYes—
deliveryPlan.idstringYesUnique identifier.
deliveryPlan.projectIdstringYesProject ID.
deliveryPlan.userIdstringYesUser ID.
deliveryPlan.organizationIdstringNo—
deliveryPlan.createdByUserIdstringNo—
deliveryPlan.schemaVersioncomputer_agents_project_delivery_contract_v4Yes—
deliveryPlan.contractobjectYes—
deliveryPlan.contract.schemaVersioncomputer_agents_project_delivery_contract_v4No—
deliveryPlan.contract.modeassisted | autonomousNo—
deliveryPlan.contract.goalstringYes—
deliveryPlan.contract.validationAssetsobject[]No—
deliveryPlan.contract.validationAssets[].idstringYesUnique identifier.
deliveryPlan.contract.validationAssets[].namestringYesHuman-readable name.
deliveryPlan.contract.validationAssets[].uristringYes—
deliveryPlan.contract.validationAssets[].kindvalidation_set | training_set | specification | source_document | otherYes—
deliveryPlan.contract.validationAssets[].sha256stringNo—
deliveryPlan.contract.agentsobjectYes—
deliveryPlan.contract.agents.executionAgentIdstringNo—
deliveryPlan.contract.agents.targetAgentIdstringYes—
deliveryPlan.contract.agents.fineTunerAgentIdstringNo—
deliveryPlan.contract.agents.reviewerUserIdstringNo—
deliveryPlan.contract.topologyobjectYes—
deliveryPlan.contract.topology.resourcesobject[]Yes—
deliveryPlan.contract.topology.resources[].keystringYes—
deliveryPlan.contract.topology.resources[].kindfunctionYes—
deliveryPlan.contract.topology.resources[].lifecyclemanaged | existingNo—
deliveryPlan.contract.topology.resources[].resourceIdstringNo—
deliveryPlan.contract.topology.resources[].versionIdstringNo—
deliveryPlan.contract.topology.resources[].deploymentRevisionstringNo—
deliveryPlan.contract.topology.resources[].namestringYesHuman-readable name.
deliveryPlan.contract.topology.resources[].descriptionstringNoHuman-readable description.
deliveryPlan.contract.topology.resources[].runtimenodejs22 | python312No—
deliveryPlan.contract.topology.resources[].regionstringNo—
deliveryPlan.contract.topology.resources[].authModepublic | privateNo—
deliveryPlan.contract.topology.resources[].sourcePathstringNoWorkspace-relative file path.
deliveryPlan.contract.topology.connectionsobject[]Yes—
deliveryPlan.contract.topology.connections[].idstringYesUnique identifier.
deliveryPlan.contract.topology.connections[].sourcestringYes—
deliveryPlan.contract.topology.connections[].targetstringYes—
deliveryPlan.contract.topology.connections[].typedepends_on | invokes | triggers | reads | writes | uses_secrets | runs_in | uses_mcpYes—
deliveryPlan.contract.topology.connections[].metadataobjectNoFree-form metadata object.
deliveryPlan.contract.servicesobjectYes—
deliveryPlan.contract.services.testsobjectYes—
deliveryPlan.contract.services.tests.enabledtrueNo—
deliveryPlan.contract.services.tests.namestringYesHuman-readable name.
deliveryPlan.contract.services.tests.descriptionstringNoHuman-readable description.
deliveryPlan.contract.services.tests.definitionobjectYes—
deliveryPlan.contract.services.tests.definition.schemaVersioncomputer_agents_test_plan_v1Yes—
deliveryPlan.contract.services.tests.definition.casesobject[]Yes—
deliveryPlan.contract.services.tests.definition.cases[].idstringYesUnique identifier.
deliveryPlan.contract.services.tests.definition.cases[].namestringYesHuman-readable name.
deliveryPlan.contract.services.tests.definition.cases[].descriptionstringYesHuman-readable description.
deliveryPlan.contract.services.tests.definition.cases[].kindcommand | contract | integration | browser | agent | security | customYes—
deliveryPlan.contract.services.tests.definition.cases[].commandstringYes—
deliveryPlan.contract.services.tests.definition.cases[].workingDirectorystringYes—
deliveryPlan.contract.services.tests.definition.cases[].timeoutMsintegerYes—
deliveryPlan.contract.services.tests.definition.cases[].retriesintegerYes—
deliveryPlan.contract.services.tests.definition.cases[].envobjectYes—
deliveryPlan.contract.services.tests.definition.cases[].secretRefsstring[]Yes—
deliveryPlan.contract.services.tests.definition.cases[].requestobjectYesKind-specific structured request. Secrets must be referenced through `secretRefs`.
deliveryPlan.contract.services.tests.definition.cases[].assertionsobject[]Yes—
deliveryPlan.contract.services.tests.definition.cases[].agentIdstringYesAgent ID.
deliveryPlan.contract.services.tests.definition.cases[].enabledbooleanYes—
deliveryPlan.contract.services.tests.definition.cases[].tagsstring[]Yes—
deliveryPlan.contract.services.tests.definition.concurrencyintegerYes—
deliveryPlan.contract.services.tests.definition.stopOnFailurebooleanYes—
deliveryPlan.contract.services.tests.definition.retryPolicyobjectYes—
deliveryPlan.contract.services.tests.definition.retryPolicy.maxAttemptsintegerYes—
deliveryPlan.contract.services.tests.definition.evidencePolicyobjectYes—
deliveryPlan.contract.services.tests.definition.evidencePolicy.retainLogsbooleanYes—
deliveryPlan.contract.services.tests.definition.evidencePolicy.retainScreenshotsbooleanYes—
deliveryPlan.contract.services.tests.definition.evidencePolicy.retainTracesbooleanYes—
deliveryPlan.contract.services.tests.definition.evidencePolicy.retainArtifactsbooleanYes—
deliveryPlan.contract.services.tests.definition.evidencePolicy.redactSecretsbooleanYes—
deliveryPlan.contract.services.evaluationobjectYes—
deliveryPlan.contract.services.evaluation.enabledtrueNo—
deliveryPlan.contract.services.evaluation.namestringYesHuman-readable name.
deliveryPlan.contract.services.evaluation.descriptionstringNoHuman-readable description.
deliveryPlan.contract.services.evaluation.casesobject[]No—
deliveryPlan.contract.services.evaluation.cases[].idstringYesUnique identifier.
deliveryPlan.contract.services.evaluation.cases[].inputstringYes—
deliveryPlan.contract.services.evaluation.cases[].expectedOutputstringYes—
deliveryPlan.contract.services.evaluation.cases[].evaluationGuidancestringYes—
deliveryPlan.contract.services.evaluation.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryPlan.contract.services.evaluation.cases[].metadataobjectNoFree-form metadata object.
deliveryPlan.contract.services.evaluation.sourceobjectNo—
deliveryPlan.contract.services.evaluation.source.typeexisting_evaluation_versionYes—
deliveryPlan.contract.services.evaluation.source.evaluationIdstringYes—
deliveryPlan.contract.services.evaluation.source.versionIdstringYes—
deliveryPlan.contract.services.evaluation.source.datasetAssetIdstringYes—
deliveryPlan.contract.services.evaluation.targetobjectNo—
deliveryPlan.contract.services.evaluation.target.kindagentYes—
deliveryPlan.contract.services.evaluation.target.agentIdstringNoAgent ID.
deliveryPlan.contract.services.evaluation.evaluatorobjectNo—
deliveryPlan.contract.services.evaluation.evaluator.typeexactYes—
deliveryPlan.contract.services.evaluation.passThresholdnumberNo—
deliveryPlan.contract.services.evaluation.datasetGovernanceobjectYes—
deliveryPlan.contract.services.evaluation.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryPlan.contract.services.evaluation.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryPlan.contract.services.evaluation.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryPlan.contract.services.evaluation.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryPlan.contract.services.evaluation.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryPlan.contract.services.evaluation.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryPlan.contract.services.evaluation.datasetGovernance.lockedAtstringYes—
deliveryPlan.contract.services.workflowAcceptanceobjectNo—
deliveryPlan.contract.services.workflowAcceptance.enabledtrueNo—
deliveryPlan.contract.services.workflowAcceptance.namestringYesHuman-readable name.
deliveryPlan.contract.services.workflowAcceptance.descriptionstringNoHuman-readable description.
deliveryPlan.contract.services.workflowAcceptance.casesobject[]No—
deliveryPlan.contract.services.workflowAcceptance.cases[].idstringYesUnique identifier.
deliveryPlan.contract.services.workflowAcceptance.cases[].inputstringYes—
deliveryPlan.contract.services.workflowAcceptance.cases[].expectedOutputstringYes—
deliveryPlan.contract.services.workflowAcceptance.cases[].evaluationGuidancestringYes—
deliveryPlan.contract.services.workflowAcceptance.cases[].optimizationRoletrain | validation | holdoutNo—
deliveryPlan.contract.services.workflowAcceptance.cases[].metadataobjectNoFree-form metadata object.
deliveryPlan.contract.services.workflowAcceptance.sourceobjectNo—
deliveryPlan.contract.services.workflowAcceptance.source.typeexisting_evaluation_versionYes—
deliveryPlan.contract.services.workflowAcceptance.source.evaluationIdstringYes—
deliveryPlan.contract.services.workflowAcceptance.source.versionIdstringYes—
deliveryPlan.contract.services.workflowAcceptance.source.datasetAssetIdstringYes—
deliveryPlan.contract.services.workflowAcceptance.targetobjectNo—
deliveryPlan.contract.services.workflowAcceptance.target.kindagentYes—
deliveryPlan.contract.services.workflowAcceptance.target.agentIdstringNoAgent ID.
deliveryPlan.contract.services.workflowAcceptance.evaluatorobjectNo—
deliveryPlan.contract.services.workflowAcceptance.evaluator.typeexactYes—
deliveryPlan.contract.services.workflowAcceptance.passThresholdnumberNo—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernanceobjectYes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.schemaVersioncomputer_agents_evaluation_dataset_governance_v1Yes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.maturitydiagnostic | development | validation | locked_test | external_testYes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.adjudicationStatuspending | in_progress | adjudicatedYes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.allowedPurposesdiagnostic | development | optimization | release | external_validation[]Yes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.annotationGuidelineVersionstringYes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.adjudicationRecordSha256stringYes—
deliveryPlan.contract.services.workflowAcceptance.datasetGovernance.lockedAtstringYes—
deliveryPlan.contract.services.optimizationobjectYes—
deliveryPlan.contract.services.optimization.enabledbooleanNo—
deliveryPlan.contract.services.optimization.namestringYesHuman-readable name.
deliveryPlan.contract.services.optimization.instructionsstringYes—
deliveryPlan.contract.services.optimization.maximumIterationsintegerNo—
deliveryPlan.contract.services.optimization.minimumImprovementnumberNo—
deliveryPlan.contract.services.optimization.maximumRegressionnumberNo—
deliveryPlan.contract.services.optimization.minimumPairedCasesintegerNo—
deliveryPlan.contract.services.optimization.minimumPairedCoveragenumberNo—
deliveryPlan.contract.services.optimization.maximumDurationMinutesintegerNo—
deliveryPlan.contract.services.optimization.maximumTransientRetriesintegerNo—
deliveryPlan.contract.services.optimization.plateauIterationsintegerNo—
deliveryPlan.contract.services.optimization.publicationModemanual | auto_on_targetNo—
deliveryPlan.contract.services.optimization.publishBestOnLimitbooleanNo—
deliveryPlan.contract.services.assuranceobjectYes—
deliveryPlan.contract.services.assurance.enabledtrueNo—
deliveryPlan.contract.services.assurance.namestringYesHuman-readable name.
deliveryPlan.contract.services.assurance.descriptionstringNoHuman-readable description.
deliveryPlan.contract.services.assurance.approvalModenone | manualNo—
deliveryPlan.contract.services.assurance.maximumEvidenceAgeHoursnumberNo—
deliveryPlan.contract.services.guardrailsobjectNo—
deliveryPlan.contract.services.guardrails.enabledbooleanNo—
deliveryPlan.contract.services.guardrails.policiesobject[]No—
deliveryPlan.contract.services.guardrails.policies[].idstringYesUnique identifier.
deliveryPlan.contract.services.guardrails.policies[].namestringYesHuman-readable name.
deliveryPlan.contract.services.guardrails.policies[].descriptionstringNoHuman-readable description.
deliveryPlan.contract.services.guardrails.policies[].promptsobject[]Yes—
deliveryPlan.contract.services.guardrails.policies[].prompts[].idstringNoUnique identifier.
deliveryPlan.contract.services.guardrails.policies[].prompts[].titlestringYesDisplay title.
deliveryPlan.contract.services.guardrails.policies[].prompts[].promptstringYes—
deliveryPlan.contract.services.guardrails.policies[].prompts[].metadataobjectNoFree-form metadata object.
deliveryPlan.contract.services.guardrails.policies[].policyobjectYes—
deliveryPlan.contract.services.guardrails.policies[].policy.schemaVersioncomputer_agents_guardrail_policy_v1Yes—
deliveryPlan.contract.services.guardrails.policies[].policy.rulesobject[]Yes—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].idstringYesUnique identifier.
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].matchobjectYes—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].match.actionClassesstring[]No—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].match.operationsstring[]No—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].match.targetKindsstring[]No—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].match.dataClassificationspublic | internal | confidential | restricted | secret[]No—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].outcomeask | denyYesGuardrails are restriction-only and cannot grant access.
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].minimumRing1 | 2 | 3No—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].severityinfo | warning | high | criticalYes—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].recommendedControldeny_effect | park | pause | cancel | quarantineYes—
deliveryPlan.contract.services.guardrails.policies[].policy.rules[].obligationshuman_approval | security_review | redact_output | verify_target | require_reversible_plan[]Yes—
deliveryPlan.contract.services.guardrails.policies[].appliesToexecution_agent | target_agent | fine_tuner_agent[]Yes—
deliveryPlan.contract.acceptanceobjectYes—
deliveryPlan.contract.acceptance.minimumAverageScorenumberYes—
deliveryPlan.contract.acceptance.minimumPassRatenumberYes—
deliveryPlan.contract.acceptance.requireAllTestsPassingtrueNo—
deliveryPlan.contract.acceptance.requirePublishedOptimizationCandidatebooleanNo—
deliveryPlan.contract.budgetobjectYes—
deliveryPlan.contract.budget.maximumTotalCostUsdnumberYes—
deliveryPlan.contract.repairPolicyobjectNoOptional bounded repair policy. Only trusted failed Test evidence or fully verified completed Evaluation evidence that missed a configured quality threshold can trigger repair. Pinned gates are rerun and a target-scoped changed resource revision is mandatory.
deliveryPlan.contract.repairPolicy.enabledbooleanNo—
deliveryPlan.contract.repairPolicy.maximumAttemptsintegerNo—
deliveryPlan.contract.repairPolicy.repairableStagestest | evaluate | acceptance_evaluate[]No—
deliveryPlan.contract.repairPolicy.requireChangedResourceRevisiontrueNo—
deliveryPlan.contractFingerprintstringYes—
deliveryPlan.graphobjectYes—
deliveryPlan.graph.schemaVersioncomputer_agents_project_delivery_graph_v1 | computer_agents_project_delivery_graph_v2Yes—
deliveryPlan.graph.contractFingerprintstringYes—
deliveryPlan.graph.nodesobject[]Yes—
deliveryPlan.graph.nodes[].idbuild | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliverYesUnique identifier.
deliveryPlan.graph.nodes[].titlestringYesDisplay title.
deliveryPlan.graph.nodes[].stateplanned | blocked | skippedYes—
deliveryPlan.graph.nodes[].dependsOnbuild | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[]Yes—
deliveryPlan.graph.nodes[].resourceTypesstring[]Yes—
deliveryPlan.graph.nodes[].taskIdstringNo—
deliveryPlan.graph.nodes[].resourceIdsstring[]No—
deliveryPlan.graph.edgesobject[]Yes—
deliveryPlan.graph.edges[].sourcestringYes—
deliveryPlan.graph.edges[].targetstringYes—
deliveryPlan.bindingsobjectYes—
deliveryPlan.statusdraft | provisioning | ready | failed | archivedYesCurrent lifecycle status.
deliveryPlan.revisionintegerYes—
deliveryPlan.idempotencyKeystringNo—
deliveryPlan.errorstringNo—
deliveryPlan.provisionedAtstringNo—
deliveryPlan.createdAtstringYesISO 8601 timestamp.
deliveryPlan.updatedAtstringYesISO 8601 timestamp.
deliveryPlan.eventsobject[]No—
deliveryPlan.events[].idstringYesUnique identifier.
deliveryPlan.events[].typestringYes—
deliveryPlan.events[].actorUserIdstringYes—
deliveryPlan.events[].payloadobjectYes—
deliveryPlan.events[].createdAtstringYesISO 8601 timestamp.
provisionedfalseYes—
executionStartedfalseYes—
404Resource not foundapplication/json
FieldTypeRequiredDescription
errorstringNo—
409The design is incomplete, stale, or cannot revise the current delivery plan
None.
Apply one exact ready design to the Project delivery plan
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow