Compile a Project brief without side effects
POST
/v1/projects/{projectId}/delivery-design/previewInfers a bounded topology, reports assumptions and typed missing inputs, and returns a canonical v3 delivery contract only when every authoritative input is present.
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
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | string | Yes | Project ID |
Query parameters
None.
Body schema
Content type: application/json · Required
| Field | Type | Required | Description |
|---|---|---|---|
| request | object | Yes | — |
| request.schemaVersion | computer_agents_project_delivery_design_request_v1 | No | — |
| request.brief | object | Yes | — |
| request.brief.name | string | No | Human-readable name. |
| request.brief.goal | string | Yes | — |
| request.brief.context | string | No | — |
| request.brief.constraints | string[] | No | — |
| request.brief.expectedOutputs | string[] | No | — |
| request.brief.workflowKind | auto | agent | scheduled_pipeline | event_driven_pipeline | service_topology | No | — |
| request.brief.schedule | string | No | — |
| request.validationAssets | object[] | No | — |
| request.validationAssets[].id | string | Yes | Unique identifier. |
| request.validationAssets[].name | string | Yes | Human-readable name. |
| request.validationAssets[].uri | string | Yes | — |
| request.validationAssets[].kind | validation_set | training_set | specification | source_document | other | Yes | — |
| request.validationAssets[].sha256 | string | No | — |
| request.capabilities | object | No | — |
| request.capabilities.managedFunction | boolean | No | — |
| request.capabilities.managedWorkflow | boolean | No | — |
| request.capabilities.persistResults | boolean | No | — |
| request.capabilities.requiredSecretKeys | string[] | No | — |
| request.topology | object | No | Optional 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. |
| request.topology.resources | object[] | No | — |
| request.topology.resources[].key | string | Yes | — |
| request.topology.resources[].kind | function | Yes | — |
| request.topology.resources[].resourceId | string | Yes | — |
| request.topology.resources[].versionId | string | Yes | — |
| request.topology.resources[].deploymentRevision | string | Yes | — |
| request.topology.resources[].name | string | Yes | Human-readable name. |
| request.topology.resources[].description | string | No | Human-readable description. |
| request.topology.resources[].runtime | nodejs22 | python312 | No | — |
| request.topology.resources[].region | string | No | — |
| request.topology.resources[].authMode | public | private | No | — |
| request.topology.connections | object[] | No | — |
| request.topology.connections[].id | string | Yes | Unique identifier. |
| request.topology.connections[].source | string | Yes | — |
| request.topology.connections[].target | string | Yes | — |
| request.topology.connections[].type | depends_on | invokes | triggers | reads | writes | uses_secrets | runs_in | Yes | — |
| request.topology.connections[].metadata | object | No | Free-form metadata object. |
| request.topology.entrypointResourceKey | string | No | — |
| request.topology.evaluationResourceKeys | string[] | No | Exact 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. |
| request.topology.entrypointInvocation | object | No | Exact invocation contract used when Evaluation targets the existing topology entrypoint. |
| request.topology.entrypointInvocation.method | GET | POST | PUT | PATCH | DELETE | No | — |
| request.topology.entrypointInvocation.path | string | No | Workspace-relative file path. |
| request.topology.entrypointInvocation.timeoutMs | integer | No | — |
| request.bindings | object | No | — |
| request.bindings.executionAgentId | string | No | — |
| request.bindings.targetAgentId | string | No | — |
| request.bindings.fineTunerAgentId | string | No | — |
| request.bindings.reviewerUserId | string | No | — |
| request.tests | object | No | — |
| request.tests.cases | object[] | No | — |
| request.evaluation | object | No | — |
| request.evaluation.cases | object[] | No | — |
| request.evaluation.cases[].id | string | Yes | Unique identifier. |
| request.evaluation.cases[].input | string | Yes | — |
| request.evaluation.cases[].expectedOutput | string | Yes | — |
| request.evaluation.cases[].evaluationGuidance | string | Yes | — |
| request.evaluation.cases[].optimizationRole | train | validation | holdout | No | — |
| request.evaluation.cases[].metadata | object | No | Free-form metadata object. |
| request.evaluation.source | object | No | — |
| request.evaluation.source.type | existing_evaluation_version | Yes | — |
| request.evaluation.source.evaluationId | string | Yes | — |
| request.evaluation.source.versionId | string | Yes | — |
| request.evaluation.source.datasetAssetId | string | Yes | — |
| request.evaluation.evaluator | object | No | — |
| request.evaluation.passThreshold | number | No | — |
| request.controls | object | No | — |
| request.controls.mode | assisted | autonomous | No | — |
| request.controls.optimizationEnabled | boolean | No | — |
| request.controls.maximumOptimizationIterations | integer | No | — |
| request.controls.guardrailPolicies | object[] | No | — |
| request.controls.assuranceApprovalMode | none | manual | No | — |
| request.controls.repairEnabled | boolean | No | — |
| request.controls.maximumRepairAttempts | integer | No | — |
| request.acceptance | object | No | — |
| request.acceptance.minimumAverageScore | number | No | — |
| request.acceptance.minimumPassRate | number | No | — |
| request.acceptance.requireAllTestsPassing | true | No | — |
| request.acceptance.requirePublishedOptimizationCandidate | boolean | No | — |
| request.budget | object | No | — |
| request.budget.maximumTotalCostUsd | number | No | — |
What the API returns
Each response code below includes the documented payload shape for the ACP API.
200Non-persisted deterministic designapplication/json
| Field | Type | Required | Description |
|---|---|---|---|
| deliveryDesign | object | Yes | — |
| deliveryDesign.schemaVersion | computer_agents_project_delivery_design_v1 | Yes | — |
| deliveryDesign.requestFingerprint | string | Yes | — |
| deliveryDesign.designFingerprint | string | Yes | — |
| deliveryDesign.readiness | ready | needs_input | Yes | — |
| deliveryDesign.archetype | agent | scheduled_pipeline | event_driven_pipeline | service_topology | Yes | — |
| deliveryDesign.missingInputs | object[] | Yes | — |
| deliveryDesign.missingInputs[].code | string | Yes | — |
| deliveryDesign.missingInputs[].path | string | Yes | Workspace-relative file path. |
| deliveryDesign.missingInputs[].message | string | Yes | Message text. |
| deliveryDesign.missingInputs[].blocking | true | Yes | — |
| deliveryDesign.assumptions | string[] | Yes | — |
| deliveryDesign.proposedTopology | object | Yes | — |
| deliveryDesign.proposedTopology.resources | object[] | Yes | — |
| deliveryDesign.proposedTopology.connections | object[] | Yes | — |
| deliveryDesign.contract | object | Yes | — |
| deliveryDesign.contract.schemaVersion | computer_agents_project_delivery_contract_v3 | No | — |
| deliveryDesign.contract.mode | assisted | autonomous | No | — |
| deliveryDesign.contract.goal | string | Yes | — |
| deliveryDesign.contract.validationAssets | object[] | No | — |
| deliveryDesign.contract.validationAssets[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.validationAssets[].name | string | Yes | Human-readable name. |
| deliveryDesign.contract.validationAssets[].uri | string | Yes | — |
| deliveryDesign.contract.validationAssets[].kind | validation_set | training_set | specification | source_document | other | Yes | — |
| deliveryDesign.contract.validationAssets[].sha256 | string | No | — |
| deliveryDesign.contract.agents | object | Yes | — |
| deliveryDesign.contract.agents.executionAgentId | string | No | — |
| deliveryDesign.contract.agents.targetAgentId | string | Yes | — |
| deliveryDesign.contract.agents.fineTunerAgentId | string | No | — |
| deliveryDesign.contract.agents.reviewerUserId | string | No | — |
| deliveryDesign.contract.topology | object | Yes | — |
| deliveryDesign.contract.topology.resources | object[] | Yes | — |
| deliveryDesign.contract.topology.resources[].key | string | Yes | — |
| deliveryDesign.contract.topology.resources[].kind | function | Yes | — |
| deliveryDesign.contract.topology.resources[].lifecycle | managed | existing | No | — |
| deliveryDesign.contract.topology.resources[].resourceId | string | No | — |
| deliveryDesign.contract.topology.resources[].versionId | string | No | — |
| deliveryDesign.contract.topology.resources[].deploymentRevision | string | No | — |
| deliveryDesign.contract.topology.resources[].name | string | Yes | Human-readable name. |
| deliveryDesign.contract.topology.resources[].description | string | No | Human-readable description. |
| deliveryDesign.contract.topology.resources[].runtime | nodejs22 | python312 | No | — |
| deliveryDesign.contract.topology.resources[].region | string | No | — |
| deliveryDesign.contract.topology.resources[].authMode | public | private | No | — |
| deliveryDesign.contract.topology.resources[].sourcePath | string | No | Workspace-relative file path. |
| deliveryDesign.contract.topology.connections | object[] | Yes | — |
| deliveryDesign.contract.topology.connections[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.topology.connections[].source | string | Yes | — |
| deliveryDesign.contract.topology.connections[].target | string | Yes | — |
| deliveryDesign.contract.topology.connections[].type | depends_on | invokes | triggers | reads | writes | uses_secrets | runs_in | uses_mcp | Yes | — |
| deliveryDesign.contract.topology.connections[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.contract.services | object | Yes | — |
| deliveryDesign.contract.services.tests | object | Yes | — |
| deliveryDesign.contract.services.tests.enabled | true | No | — |
| deliveryDesign.contract.services.tests.name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.tests.description | string | No | Human-readable description. |
| deliveryDesign.contract.services.tests.definition | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.schemaVersion | computer_agents_test_plan_v1 | Yes | — |
| deliveryDesign.contract.services.tests.definition.setup | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.setup.command | string | Yes | — |
| deliveryDesign.contract.services.tests.definition.setup.workingDirectory | string | Yes | — |
| deliveryDesign.contract.services.tests.definition.setup.timeoutMs | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.setup.env | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.setup.secretRefs | string[] | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases | object[] | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.services.tests.definition.cases[].name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.tests.definition.cases[].description | string | Yes | Human-readable description. |
| deliveryDesign.contract.services.tests.definition.cases[].kind | command | contract | integration | browser | agent | security | custom | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].command | string | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].workingDirectory | string | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].timeoutMs | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].retries | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].env | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].secretRefs | string[] | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].request | object | Yes | Kind-specific structured request. Secrets must be referenced through `secretRefs`. |
| deliveryDesign.contract.services.tests.definition.cases[].assertions | object[] | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].agentId | string | Yes | Agent ID. |
| deliveryDesign.contract.services.tests.definition.cases[].enabled | boolean | Yes | — |
| deliveryDesign.contract.services.tests.definition.cases[].tags | string[] | Yes | — |
| deliveryDesign.contract.services.tests.definition.teardown | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.teardown.command | string | Yes | — |
| deliveryDesign.contract.services.tests.definition.teardown.workingDirectory | string | Yes | — |
| deliveryDesign.contract.services.tests.definition.teardown.timeoutMs | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.teardown.env | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.teardown.secretRefs | string[] | Yes | — |
| deliveryDesign.contract.services.tests.definition.concurrency | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.stopOnFailure | boolean | Yes | — |
| deliveryDesign.contract.services.tests.definition.retryPolicy | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.retryPolicy.maxAttempts | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.retryPolicy.backoffMs | integer | Yes | — |
| deliveryDesign.contract.services.tests.definition.evidencePolicy | object | Yes | — |
| deliveryDesign.contract.services.tests.definition.evidencePolicy.retainLogs | boolean | Yes | — |
| deliveryDesign.contract.services.tests.definition.evidencePolicy.retainScreenshots | boolean | Yes | — |
| deliveryDesign.contract.services.tests.definition.evidencePolicy.retainTraces | boolean | Yes | — |
| deliveryDesign.contract.services.tests.definition.evidencePolicy.retainArtifacts | boolean | Yes | — |
| deliveryDesign.contract.services.tests.definition.evidencePolicy.redactSecrets | boolean | Yes | — |
| deliveryDesign.contract.services.evaluation | object | Yes | — |
| deliveryDesign.contract.services.evaluation.enabled | true | No | — |
| deliveryDesign.contract.services.evaluation.name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.evaluation.description | string | No | Human-readable description. |
| deliveryDesign.contract.services.evaluation.cases | object[] | No | — |
| deliveryDesign.contract.services.evaluation.cases[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.services.evaluation.cases[].input | string | Yes | — |
| deliveryDesign.contract.services.evaluation.cases[].expectedOutput | string | Yes | — |
| deliveryDesign.contract.services.evaluation.cases[].evaluationGuidance | string | Yes | — |
| deliveryDesign.contract.services.evaluation.cases[].optimizationRole | train | validation | holdout | No | — |
| deliveryDesign.contract.services.evaluation.cases[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.contract.services.evaluation.source | object | No | — |
| deliveryDesign.contract.services.evaluation.source.type | existing_evaluation_version | Yes | — |
| deliveryDesign.contract.services.evaluation.source.evaluationId | string | Yes | — |
| deliveryDesign.contract.services.evaluation.source.versionId | string | Yes | — |
| deliveryDesign.contract.services.evaluation.source.datasetAssetId | string | Yes | — |
| deliveryDesign.contract.services.evaluation.target | object | No | — |
| deliveryDesign.contract.services.evaluation.target.kind | agent | Yes | — |
| deliveryDesign.contract.services.evaluation.target.agentId | string | No | Agent ID. |
| deliveryDesign.contract.services.evaluation.evaluator | object | No | — |
| deliveryDesign.contract.services.evaluation.evaluator.type | exact | Yes | — |
| deliveryDesign.contract.services.evaluation.passThreshold | number | No | — |
| deliveryDesign.contract.services.workflowAcceptance | object | No | — |
| deliveryDesign.contract.services.workflowAcceptance.enabled | true | No | — |
| deliveryDesign.contract.services.workflowAcceptance.name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.workflowAcceptance.description | string | No | Human-readable description. |
| deliveryDesign.contract.services.workflowAcceptance.cases | object[] | No | — |
| deliveryDesign.contract.services.workflowAcceptance.cases[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.services.workflowAcceptance.cases[].input | string | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.cases[].expectedOutput | string | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.cases[].evaluationGuidance | string | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.cases[].optimizationRole | train | validation | holdout | No | — |
| deliveryDesign.contract.services.workflowAcceptance.cases[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.contract.services.workflowAcceptance.source | object | No | — |
| deliveryDesign.contract.services.workflowAcceptance.source.type | existing_evaluation_version | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.source.evaluationId | string | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.source.versionId | string | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.source.datasetAssetId | string | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.target | object | No | — |
| deliveryDesign.contract.services.workflowAcceptance.target.kind | agent | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.target.agentId | string | No | Agent ID. |
| deliveryDesign.contract.services.workflowAcceptance.evaluator | object | No | — |
| deliveryDesign.contract.services.workflowAcceptance.evaluator.type | exact | Yes | — |
| deliveryDesign.contract.services.workflowAcceptance.passThreshold | number | No | — |
| deliveryDesign.contract.services.optimization | object | Yes | — |
| deliveryDesign.contract.services.optimization.enabled | boolean | No | — |
| deliveryDesign.contract.services.optimization.name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.optimization.instructions | string | Yes | — |
| deliveryDesign.contract.services.optimization.maximumIterations | integer | No | — |
| deliveryDesign.contract.services.optimization.minimumImprovement | number | No | — |
| deliveryDesign.contract.services.optimization.maximumRegression | number | No | — |
| deliveryDesign.contract.services.optimization.minimumPairedCases | integer | No | — |
| deliveryDesign.contract.services.optimization.minimumPairedCoverage | number | No | — |
| deliveryDesign.contract.services.optimization.maximumDurationMinutes | integer | No | — |
| deliveryDesign.contract.services.optimization.maximumTransientRetries | integer | No | — |
| deliveryDesign.contract.services.optimization.plateauIterations | integer | No | — |
| deliveryDesign.contract.services.optimization.publicationMode | manual | auto_on_target | No | — |
| deliveryDesign.contract.services.optimization.publishBestOnLimit | boolean | No | — |
| deliveryDesign.contract.services.assurance | object | Yes | — |
| deliveryDesign.contract.services.assurance.enabled | true | No | — |
| deliveryDesign.contract.services.assurance.name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.assurance.description | string | No | Human-readable description. |
| deliveryDesign.contract.services.assurance.approvalMode | none | manual | No | — |
| deliveryDesign.contract.services.assurance.maximumEvidenceAgeHours | number | No | — |
| deliveryDesign.contract.services.guardrails | object | No | — |
| deliveryDesign.contract.services.guardrails.enabled | boolean | No | — |
| deliveryDesign.contract.services.guardrails.policies | object[] | No | — |
| deliveryDesign.contract.services.guardrails.policies[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.services.guardrails.policies[].name | string | Yes | Human-readable name. |
| deliveryDesign.contract.services.guardrails.policies[].description | string | No | Human-readable description. |
| deliveryDesign.contract.services.guardrails.policies[].prompts | object[] | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].prompts[].id | string | No | Unique identifier. |
| deliveryDesign.contract.services.guardrails.policies[].prompts[].title | string | Yes | Display title. |
| deliveryDesign.contract.services.guardrails.policies[].prompts[].prompt | string | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].prompts[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.contract.services.guardrails.policies[].policy | object | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.schemaVersion | computer_agents_guardrail_policy_v1 | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules | object[] | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].id | string | Yes | Unique identifier. |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].match | object | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].match.actionClasses | string[] | No | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].match.operations | string[] | No | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].match.targetKinds | string[] | No | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].match.dataClassifications | public | internal | confidential | restricted | secret[] | No | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].outcome | ask | deny | Yes | Guardrails are restriction-only and cannot grant access. |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].minimumRing | 1 | 2 | 3 | No | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].severity | info | warning | high | critical | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].recommendedControl | deny_effect | park | pause | cancel | quarantine | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].policy.rules[].obligations | human_approval | security_review | redact_output | verify_target | require_reversible_plan[] | Yes | — |
| deliveryDesign.contract.services.guardrails.policies[].appliesTo | execution_agent | target_agent | fine_tuner_agent[] | Yes | — |
| deliveryDesign.contract.acceptance | object | Yes | — |
| deliveryDesign.contract.acceptance.minimumAverageScore | number | Yes | — |
| deliveryDesign.contract.acceptance.minimumPassRate | number | Yes | — |
| deliveryDesign.contract.acceptance.requireAllTestsPassing | true | No | — |
| deliveryDesign.contract.acceptance.requirePublishedOptimizationCandidate | boolean | No | — |
| deliveryDesign.contract.budget | object | Yes | — |
| deliveryDesign.contract.budget.maximumTotalCostUsd | number | Yes | — |
| deliveryDesign.contract.repairPolicy | object | No | Optional 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.contract.repairPolicy.enabled | boolean | No | — |
| deliveryDesign.contract.repairPolicy.maximumAttempts | integer | No | — |
| deliveryDesign.contract.repairPolicy.repairableStages | test | evaluate | acceptance_evaluate[] | No | — |
| deliveryDesign.contract.repairPolicy.requireChangedResourceRevision | true | No | — |
| deliveryDesign.preview | object | Yes | — |
| deliveryDesign.preview.schemaVersion | computer_agents_project_delivery_preview_v1 | Yes | — |
| deliveryDesign.preview.contractSchemaVersion | computer_agents_project_delivery_contract_v3 | Yes | — |
| deliveryDesign.preview.contractFingerprint | string | Yes | — |
| deliveryDesign.preview.contract | object | Yes | — |
| deliveryDesign.preview.contract.schemaVersion | computer_agents_project_delivery_contract_v3 | No | — |
| deliveryDesign.preview.contract.mode | assisted | autonomous | No | — |
| deliveryDesign.preview.contract.goal | string | Yes | — |
| deliveryDesign.preview.contract.validationAssets | object[] | No | — |
| deliveryDesign.preview.contract.validationAssets[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.validationAssets[].name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.validationAssets[].uri | string | Yes | — |
| deliveryDesign.preview.contract.validationAssets[].kind | validation_set | training_set | specification | source_document | other | Yes | — |
| deliveryDesign.preview.contract.validationAssets[].sha256 | string | No | — |
| deliveryDesign.preview.contract.agents | object | Yes | — |
| deliveryDesign.preview.contract.agents.executionAgentId | string | No | — |
| deliveryDesign.preview.contract.agents.targetAgentId | string | Yes | — |
| deliveryDesign.preview.contract.agents.fineTunerAgentId | string | No | — |
| deliveryDesign.preview.contract.agents.reviewerUserId | string | No | — |
| deliveryDesign.preview.contract.topology | object | Yes | — |
| deliveryDesign.preview.contract.topology.resources | object[] | Yes | — |
| deliveryDesign.preview.contract.topology.resources[].key | string | Yes | — |
| deliveryDesign.preview.contract.topology.resources[].kind | function | Yes | — |
| deliveryDesign.preview.contract.topology.resources[].lifecycle | managed | existing | No | — |
| deliveryDesign.preview.contract.topology.resources[].resourceId | string | No | — |
| deliveryDesign.preview.contract.topology.resources[].versionId | string | No | — |
| deliveryDesign.preview.contract.topology.resources[].deploymentRevision | string | No | — |
| deliveryDesign.preview.contract.topology.resources[].name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.topology.resources[].description | string | No | Human-readable description. |
| deliveryDesign.preview.contract.topology.resources[].runtime | nodejs22 | python312 | No | — |
| deliveryDesign.preview.contract.topology.resources[].region | string | No | — |
| deliveryDesign.preview.contract.topology.resources[].authMode | public | private | No | — |
| deliveryDesign.preview.contract.topology.resources[].sourcePath | string | No | Workspace-relative file path. |
| deliveryDesign.preview.contract.topology.connections | object[] | Yes | — |
| deliveryDesign.preview.contract.topology.connections[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.topology.connections[].source | string | Yes | — |
| deliveryDesign.preview.contract.topology.connections[].target | string | Yes | — |
| deliveryDesign.preview.contract.topology.connections[].type | depends_on | invokes | triggers | reads | writes | uses_secrets | runs_in | uses_mcp | Yes | — |
| deliveryDesign.preview.contract.topology.connections[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.preview.contract.services | object | Yes | — |
| deliveryDesign.preview.contract.services.tests | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.enabled | true | No | — |
| deliveryDesign.preview.contract.services.tests.name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.tests.description | string | No | Human-readable description. |
| deliveryDesign.preview.contract.services.tests.definition | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.schemaVersion | computer_agents_test_plan_v1 | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.setup | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.setup.command | string | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.setup.workingDirectory | string | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.setup.timeoutMs | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.setup.env | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.setup.secretRefs | string[] | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases | object[] | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.services.tests.definition.cases[].name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.tests.definition.cases[].description | string | Yes | Human-readable description. |
| deliveryDesign.preview.contract.services.tests.definition.cases[].kind | command | contract | integration | browser | agent | security | custom | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].command | string | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].workingDirectory | string | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].timeoutMs | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].retries | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].env | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].secretRefs | string[] | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].request | object | Yes | Kind-specific structured request. Secrets must be referenced through `secretRefs`. |
| deliveryDesign.preview.contract.services.tests.definition.cases[].assertions | object[] | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].agentId | string | Yes | Agent ID. |
| deliveryDesign.preview.contract.services.tests.definition.cases[].enabled | boolean | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.cases[].tags | string[] | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.teardown | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.teardown.command | string | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.teardown.workingDirectory | string | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.teardown.timeoutMs | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.teardown.env | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.teardown.secretRefs | string[] | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.concurrency | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.stopOnFailure | boolean | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.retryPolicy | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.retryPolicy.maxAttempts | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.retryPolicy.backoffMs | integer | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.evidencePolicy | object | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.evidencePolicy.retainLogs | boolean | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.evidencePolicy.retainScreenshots | boolean | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.evidencePolicy.retainTraces | boolean | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.evidencePolicy.retainArtifacts | boolean | Yes | — |
| deliveryDesign.preview.contract.services.tests.definition.evidencePolicy.redactSecrets | boolean | Yes | — |
| deliveryDesign.preview.contract.services.evaluation | object | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.enabled | true | No | — |
| deliveryDesign.preview.contract.services.evaluation.name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.evaluation.description | string | No | Human-readable description. |
| deliveryDesign.preview.contract.services.evaluation.cases | object[] | No | — |
| deliveryDesign.preview.contract.services.evaluation.cases[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.services.evaluation.cases[].input | string | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.cases[].expectedOutput | string | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.cases[].evaluationGuidance | string | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.cases[].optimizationRole | train | validation | holdout | No | — |
| deliveryDesign.preview.contract.services.evaluation.cases[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.preview.contract.services.evaluation.source | object | No | — |
| deliveryDesign.preview.contract.services.evaluation.source.type | existing_evaluation_version | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.source.evaluationId | string | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.source.versionId | string | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.source.datasetAssetId | string | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.target | object | No | — |
| deliveryDesign.preview.contract.services.evaluation.target.kind | agent | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.target.agentId | string | No | Agent ID. |
| deliveryDesign.preview.contract.services.evaluation.evaluator | object | No | — |
| deliveryDesign.preview.contract.services.evaluation.evaluator.type | exact | Yes | — |
| deliveryDesign.preview.contract.services.evaluation.passThreshold | number | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance | object | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.enabled | true | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.workflowAcceptance.description | string | No | Human-readable description. |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases | object[] | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases[].input | string | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases[].expectedOutput | string | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases[].evaluationGuidance | string | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases[].optimizationRole | train | validation | holdout | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.cases[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.preview.contract.services.workflowAcceptance.source | object | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.source.type | existing_evaluation_version | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.source.evaluationId | string | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.source.versionId | string | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.source.datasetAssetId | string | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.target | object | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.target.kind | agent | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.target.agentId | string | No | Agent ID. |
| deliveryDesign.preview.contract.services.workflowAcceptance.evaluator | object | No | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.evaluator.type | exact | Yes | — |
| deliveryDesign.preview.contract.services.workflowAcceptance.passThreshold | number | No | — |
| deliveryDesign.preview.contract.services.optimization | object | Yes | — |
| deliveryDesign.preview.contract.services.optimization.enabled | boolean | No | — |
| deliveryDesign.preview.contract.services.optimization.name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.optimization.instructions | string | Yes | — |
| deliveryDesign.preview.contract.services.optimization.maximumIterations | integer | No | — |
| deliveryDesign.preview.contract.services.optimization.minimumImprovement | number | No | — |
| deliveryDesign.preview.contract.services.optimization.maximumRegression | number | No | — |
| deliveryDesign.preview.contract.services.optimization.minimumPairedCases | integer | No | — |
| deliveryDesign.preview.contract.services.optimization.minimumPairedCoverage | number | No | — |
| deliveryDesign.preview.contract.services.optimization.maximumDurationMinutes | integer | No | — |
| deliveryDesign.preview.contract.services.optimization.maximumTransientRetries | integer | No | — |
| deliveryDesign.preview.contract.services.optimization.plateauIterations | integer | No | — |
| deliveryDesign.preview.contract.services.optimization.publicationMode | manual | auto_on_target | No | — |
| deliveryDesign.preview.contract.services.optimization.publishBestOnLimit | boolean | No | — |
| deliveryDesign.preview.contract.services.assurance | object | Yes | — |
| deliveryDesign.preview.contract.services.assurance.enabled | true | No | — |
| deliveryDesign.preview.contract.services.assurance.name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.assurance.description | string | No | Human-readable description. |
| deliveryDesign.preview.contract.services.assurance.approvalMode | none | manual | No | — |
| deliveryDesign.preview.contract.services.assurance.maximumEvidenceAgeHours | number | No | — |
| deliveryDesign.preview.contract.services.guardrails | object | No | — |
| deliveryDesign.preview.contract.services.guardrails.enabled | boolean | No | — |
| deliveryDesign.preview.contract.services.guardrails.policies | object[] | No | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.services.guardrails.policies[].name | string | Yes | Human-readable name. |
| deliveryDesign.preview.contract.services.guardrails.policies[].description | string | No | Human-readable description. |
| deliveryDesign.preview.contract.services.guardrails.policies[].prompts | object[] | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].prompts[].id | string | No | Unique identifier. |
| deliveryDesign.preview.contract.services.guardrails.policies[].prompts[].title | string | Yes | Display title. |
| deliveryDesign.preview.contract.services.guardrails.policies[].prompts[].prompt | string | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].prompts[].metadata | object | No | Free-form metadata object. |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy | object | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.schemaVersion | computer_agents_guardrail_policy_v1 | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules | object[] | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].id | string | Yes | Unique identifier. |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].match | object | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].outcome | ask | deny | Yes | Guardrails are restriction-only and cannot grant access. |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].minimumRing | 1 | 2 | 3 | No | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].severity | info | warning | high | critical | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].recommendedControl | deny_effect | park | pause | cancel | quarantine | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].policy.rules[].obligations | human_approval | security_review | redact_output | verify_target | require_reversible_plan[] | Yes | — |
| deliveryDesign.preview.contract.services.guardrails.policies[].appliesTo | execution_agent | target_agent | fine_tuner_agent[] | Yes | — |
| deliveryDesign.preview.contract.acceptance | object | Yes | — |
| deliveryDesign.preview.contract.acceptance.minimumAverageScore | number | Yes | — |
| deliveryDesign.preview.contract.acceptance.minimumPassRate | number | Yes | — |
| deliveryDesign.preview.contract.acceptance.requireAllTestsPassing | true | No | — |
| deliveryDesign.preview.contract.acceptance.requirePublishedOptimizationCandidate | boolean | No | — |
| deliveryDesign.preview.contract.budget | object | Yes | — |
| deliveryDesign.preview.contract.budget.maximumTotalCostUsd | number | Yes | — |
| deliveryDesign.preview.contract.repairPolicy | object | No | Optional 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.preview.contract.repairPolicy.enabled | boolean | No | — |
| deliveryDesign.preview.contract.repairPolicy.maximumAttempts | integer | No | — |
| deliveryDesign.preview.contract.repairPolicy.repairableStages | test | evaluate | acceptance_evaluate[] | No | — |
| deliveryDesign.preview.contract.repairPolicy.requireChangedResourceRevision | true | No | — |
| deliveryDesign.preview.graph | object | Yes | — |
| deliveryDesign.preview.graph.schemaVersion | computer_agents_project_delivery_graph_v1 | computer_agents_project_delivery_graph_v2 | Yes | — |
| deliveryDesign.preview.graph.contractFingerprint | string | Yes | — |
| deliveryDesign.preview.graph.nodes | object[] | Yes | — |
| deliveryDesign.preview.graph.nodes[].id | build | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver | Yes | Unique identifier. |
| deliveryDesign.preview.graph.nodes[].title | string | Yes | Display title. |
| deliveryDesign.preview.graph.nodes[].state | planned | blocked | skipped | Yes | — |
| deliveryDesign.preview.graph.nodes[].dependsOn | build | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[] | Yes | — |
| deliveryDesign.preview.graph.nodes[].resourceTypes | string[] | Yes | — |
| deliveryDesign.preview.graph.nodes[].taskId | string | No | — |
| deliveryDesign.preview.graph.nodes[].resourceIds | string[] | No | — |
| deliveryDesign.preview.graph.edges | object[] | Yes | — |
| deliveryDesign.preview.graph.edges[].source | string | Yes | — |
| deliveryDesign.preview.graph.edges[].target | string | Yes | — |
| deliveryDesign.preview.intent | object | Yes | — |
| deliveryDesign.preview.intent.mode | assisted | autonomous | Yes | — |
| deliveryDesign.preview.intent.goal | string | Yes | — |
| deliveryDesign.preview.validationAssets | object | Yes | — |
| deliveryDesign.preview.validationAssets.total | integer | Yes | — |
| deliveryDesign.preview.validationAssets.digestBound | integer | Yes | — |
| deliveryDesign.preview.validationAssets.byKind | object | Yes | — |
| deliveryDesign.preview.validationAssets.byKind.validation_set | integer | Yes | — |
| deliveryDesign.preview.validationAssets.byKind.training_set | integer | Yes | — |
| deliveryDesign.preview.validationAssets.byKind.specification | integer | Yes | — |
| deliveryDesign.preview.validationAssets.byKind.source_document | integer | Yes | — |
| deliveryDesign.preview.validationAssets.byKind.other | integer | Yes | — |
| deliveryDesign.preview.topology | object | Yes | — |
| deliveryDesign.preview.topology.resourceCount | integer | Yes | — |
| deliveryDesign.preview.topology.connectionCount | integer | Yes | — |
| deliveryDesign.preview.topology.managedResourceCount | integer | Yes | — |
| deliveryDesign.preview.topology.existingResourceCount | integer | Yes | — |
| deliveryDesign.preview.topology.resourceKinds | object | Yes | — |
| deliveryDesign.preview.topology.resources | object[] | Yes | — |
| deliveryDesign.preview.topology.resources[].key | string | Yes | — |
| deliveryDesign.preview.topology.resources[].kind | function | metronome | database | secrets | agent | environment | mcp_server | source_asset | Yes | — |
| deliveryDesign.preview.topology.resources[].lifecycle | managed | existing | Yes | — |
| deliveryDesign.preview.topology.resources[].name | string | Yes | Human-readable name. |
| deliveryDesign.preview.topology.resources[].resourceId | string | Yes | — |
| deliveryDesign.preview.stages | object | Yes | — |
| deliveryDesign.preview.stages.active | build | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[] | Yes | — |
| deliveryDesign.preview.stages.skipped | build | test | evaluate | optimize | re_evaluate | acceptance_evaluate | assure | release | deliver[] | Yes | — |
| deliveryDesign.preview.services | object | Yes | — |
| deliveryDesign.preview.services.tests | object | Yes | — |
| deliveryDesign.preview.services.tests.caseCount | integer | Yes | — |
| deliveryDesign.preview.services.tests.caseKinds | string[] | Yes | — |
| deliveryDesign.preview.services.componentEvaluation | object | Yes | — |
| deliveryDesign.preview.services.componentEvaluation.source | inline | existing_evaluation_version | Yes | — |
| deliveryDesign.preview.services.componentEvaluation.caseCount | integer | Yes | — |
| deliveryDesign.preview.services.componentEvaluation.targetKind | agent | function | metronome | service_topology | Yes | — |
| deliveryDesign.preview.services.componentEvaluation.evaluatorType | exact | agent | deterministic | Yes | — |
| deliveryDesign.preview.services.componentEvaluation.passThreshold | number | Yes | — |
| deliveryDesign.preview.services.workflowAcceptance | object | Yes | — |
| deliveryDesign.preview.services.workflowAcceptance.source | inline | existing_evaluation_version | Yes | — |
| deliveryDesign.preview.services.workflowAcceptance.caseCount | integer | Yes | — |
| deliveryDesign.preview.services.workflowAcceptance.targetKind | agent | function | metronome | service_topology | Yes | — |
| deliveryDesign.preview.services.workflowAcceptance.evaluatorType | exact | agent | deterministic | Yes | — |
| deliveryDesign.preview.services.workflowAcceptance.passThreshold | number | Yes | — |
| deliveryDesign.preview.services.optimization | object | Yes | — |
| deliveryDesign.preview.services.optimization.enabled | boolean | Yes | — |
| deliveryDesign.preview.services.optimization.maximumIterations | integer | Yes | — |
| deliveryDesign.preview.services.optimization.publicationMode | manual | auto_on_target | Yes | — |
| deliveryDesign.preview.services.optimization.publishBestOnLimit | boolean | Yes | — |
| deliveryDesign.preview.services.guardrails | object | Yes | — |
| deliveryDesign.preview.services.guardrails.enabled | boolean | Yes | — |
| deliveryDesign.preview.services.guardrails.policyCount | integer | Yes | — |
| deliveryDesign.preview.services.guardrails.promptCount | integer | Yes | — |
| deliveryDesign.preview.services.assurance | object | Yes | — |
| deliveryDesign.preview.services.assurance.approvalMode | none | manual | Yes | — |
| deliveryDesign.preview.services.assurance.maximumEvidenceAgeHours | number | Yes | — |
| deliveryDesign.preview.acceptance | object | Yes | — |
| deliveryDesign.preview.acceptance.minimumAverageScore | number | Yes | — |
| deliveryDesign.preview.acceptance.minimumPassRate | number | Yes | — |
| deliveryDesign.preview.acceptance.requireAllTestsPassing | true | Yes | — |
| deliveryDesign.preview.acceptance.requirePublishedOptimizationCandidate | boolean | Yes | — |
| deliveryDesign.preview.budget | object | Yes | — |
| deliveryDesign.preview.budget.maximumTotalCostUsd | number | Yes | — |
| deliveryDesign.preview.repairPolicy | object | Yes | — |
| deliveryDesign.preview.repairPolicy.enabled | boolean | Yes | — |
| deliveryDesign.preview.repairPolicy.maximumAttempts | integer | Yes | — |
| deliveryDesign.preview.repairPolicy.repairableStages | test | evaluate | acceptance_evaluate[] | Yes | — |
| deliveryDesign.preview.repairPolicy.requireChangedResourceRevision | true | Yes | — |
| persisted | false | Yes | — |
| sideEffects | string[] | Yes | — |
400Invalid closed-schema design request
None.
404Resource not foundapplication/json
| Field | Type | Required | Description |
|---|---|---|---|
| error | string | No | — |
Compile a Project brief without side effects
Loading...
Response 200
Loading...