Get the current Project delivery design

GET/v1/projects/{projectId}/delivery-design

Returns the current immutable brief/compiler result revision and append-only design events. It does not provision or execute resources.

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.

Body schema

This endpoint does not require a request body.

None.

What the API returns

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

200Current Project delivery designapplication/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.passThresholdnumberNo
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_v3No
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.setupobjectYes
deliveryDesign.design.contract.services.tests.definition.setup.commandstringYes
deliveryDesign.design.contract.services.tests.definition.setup.workingDirectorystringYes
deliveryDesign.design.contract.services.tests.definition.setup.timeoutMsintegerYes
deliveryDesign.design.contract.services.tests.definition.setup.envobjectYes
deliveryDesign.design.contract.services.tests.definition.setup.secretRefsstring[]Yes
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.teardownobjectYes
deliveryDesign.design.contract.services.tests.definition.teardown.commandstringYes
deliveryDesign.design.contract.services.tests.definition.teardown.workingDirectorystringYes
deliveryDesign.design.contract.services.tests.definition.teardown.timeoutMsintegerYes
deliveryDesign.design.contract.services.tests.definition.teardown.envobjectYes
deliveryDesign.design.contract.services.tests.definition.teardown.secretRefsstring[]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.retryPolicy.backoffMsintegerYes
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.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.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_v3Yes
deliveryDesign.design.preview.contractFingerprintstringYes
deliveryDesign.design.preview.contractobjectYes
deliveryDesign.design.preview.contract.schemaVersioncomputer_agents_project_delivery_contract_v3No
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.setupobjectYes
deliveryDesign.design.preview.contract.services.tests.definition.setup.commandstringYes
deliveryDesign.design.preview.contract.services.tests.definition.setup.workingDirectorystringYes
deliveryDesign.design.preview.contract.services.tests.definition.setup.timeoutMsintegerYes
deliveryDesign.design.preview.contract.services.tests.definition.setup.envobjectYes
deliveryDesign.design.preview.contract.services.tests.definition.setup.secretRefsstring[]Yes
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.teardownobjectYes
deliveryDesign.design.preview.contract.services.tests.definition.teardown.commandstringYes
deliveryDesign.design.preview.contract.services.tests.definition.teardown.workingDirectorystringYes
deliveryDesign.design.preview.contract.services.tests.definition.teardown.timeoutMsintegerYes
deliveryDesign.design.preview.contract.services.tests.definition.teardown.envobjectYes
deliveryDesign.design.preview.contract.services.tests.definition.teardown.secretRefsstring[]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.retryPolicy.backoffMsintegerYes
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.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.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.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.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.
404Resource not foundapplication/json
FieldTypeRequiredDescription
errorstringNo
501Project delivery designs require PostgreSQL
None.
Get the current Project delivery design
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow