List accessible Assurance Policies

GET/v1/assurance/policies

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
None.
Query parameters
NameLocationTypeRequiredDescription
projectIdquerystringNo
statusquerydraft | active | archivedNo
qquerystringNo
limitqueryintegerNo
offsetqueryintegerNo

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.

200Organization-scoped Assurance Policiesapplication/json
FieldTypeRequiredDescription
objectlistYes
dataobject[]Yes
data[].idstringYesUnique identifier.
data[].projectIdstringYesProject ID.
data[].namestringYesHuman-readable name.
data[].descriptionstringYesHuman-readable description.
data[].statusdraft | active | archivedYesCurrent lifecycle status.
data[].definitionobjectYesAt least one test, evaluation, or optimization gate is required. Gate IDs are unique across all gate kinds.
data[].definition.schemaVersioncomputer_agents_assurance_policy_v2No
data[].definition.testGatesobject[]No
data[].definition.testGates[].idstringNoUnique identifier.
data[].definition.testGates[].testPlanIdstringYes
data[].definition.testGates[].versionIdstringNo
data[].definition.testGates[].requireCommitShabooleanNo
data[].definition.testGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance. Disable only for an explicitly approved legacy/non-release migration policy.
data[].definition.testGates[].maxAgeHoursnumberNo
data[].definition.evaluationGatesobject[]No
data[].definition.evaluationGates[].idstringNoUnique identifier.
data[].definition.evaluationGates[].evaluationIdstringYes
data[].definition.evaluationGates[].versionIdstringNo
data[].definition.evaluationGates[].minimumAverageScorenumberNo
data[].definition.evaluationGates[].minimumPassRatenumberNo
data[].definition.evaluationGates[].requireRunFingerprintbooleanNo
data[].definition.evaluationGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance for the exact Evaluation result set and immutable bindings.
data[].definition.evaluationGates[].requireSignedEvidencebooleanNoRequire the canonical Evaluation evidence fingerprint to carry a cryptographically verified Google Cloud KMS signature.
data[].definition.evaluationGates[].maxAgeHoursnumberNo
data[].definition.optimizationGatesobject[]No
data[].definition.optimizationGates[].idstringNoUnique identifier.
data[].definition.optimizationGates[].agentIdstringYesAgent ID.
data[].definition.optimizationGates[].requireTargetMetbooleanNo
data[].definition.optimizationGates[].requirePublishedCandidatebooleanNo
data[].definition.optimizationGates[].maxAgeHoursnumberNo
data[].definition.approvalobjectNo
data[].definition.approval.modenone | manualNo
data[].definition.budgetobjectNo
data[].definition.budget.maximumTotalCostUsdnumberNo
data[].policyFingerprintstringYes
data[].publishedVersionIdstringYes
data[].metadataobjectYesFree-form metadata object.
data[].createdAtstringYesISO 8601 timestamp.
data[].updatedAtstringYesISO 8601 timestamp.
data[].versionsobject[]No
data[].versions[].idstringYesUnique identifier.
data[].versions[].assurancePolicyIdstringYes
data[].versions[].versionintegerYes
data[].versions[].labelstringYes
data[].versions[].descriptionstringYesHuman-readable description.
data[].versions[].statussaved | published | archivedYesCurrent lifecycle status.
data[].versions[].snapshotobjectYes
data[].versions[].snapshot.namestringYesHuman-readable name.
data[].versions[].snapshot.descriptionstringYesHuman-readable description.
data[].versions[].snapshot.statusdraft | active | archivedYesCurrent lifecycle status.
data[].versions[].snapshot.projectIdstringYesProject ID.
data[].versions[].snapshot.definitionobjectYesAt least one test, evaluation, or optimization gate is required. Gate IDs are unique across all gate kinds.
data[].versions[].snapshot.definition.schemaVersioncomputer_agents_assurance_policy_v2No
data[].versions[].snapshot.definition.testGatesobject[]No
data[].versions[].snapshot.definition.testGates[].idstringNoUnique identifier.
data[].versions[].snapshot.definition.testGates[].testPlanIdstringYes
data[].versions[].snapshot.definition.testGates[].versionIdstringNo
data[].versions[].snapshot.definition.testGates[].requireCommitShabooleanNo
data[].versions[].snapshot.definition.testGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance. Disable only for an explicitly approved legacy/non-release migration policy.
data[].versions[].snapshot.definition.testGates[].maxAgeHoursnumberNo
data[].versions[].snapshot.definition.evaluationGatesobject[]No
data[].versions[].snapshot.definition.evaluationGates[].idstringNoUnique identifier.
data[].versions[].snapshot.definition.evaluationGates[].evaluationIdstringYes
data[].versions[].snapshot.definition.evaluationGates[].versionIdstringNo
data[].versions[].snapshot.definition.evaluationGates[].minimumAverageScorenumberNo
data[].versions[].snapshot.definition.evaluationGates[].minimumPassRatenumberNo
data[].versions[].snapshot.definition.evaluationGates[].requireRunFingerprintbooleanNo
data[].versions[].snapshot.definition.evaluationGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance for the exact Evaluation result set and immutable bindings.
data[].versions[].snapshot.definition.evaluationGates[].requireSignedEvidencebooleanNoRequire the canonical Evaluation evidence fingerprint to carry a cryptographically verified Google Cloud KMS signature.
data[].versions[].snapshot.definition.evaluationGates[].maxAgeHoursnumberNo
data[].versions[].snapshot.definition.optimizationGatesobject[]No
data[].versions[].snapshot.definition.optimizationGates[].idstringNoUnique identifier.
data[].versions[].snapshot.definition.optimizationGates[].agentIdstringYesAgent ID.
data[].versions[].snapshot.definition.optimizationGates[].requireTargetMetbooleanNo
data[].versions[].snapshot.definition.optimizationGates[].requirePublishedCandidatebooleanNo
data[].versions[].snapshot.definition.optimizationGates[].maxAgeHoursnumberNo
data[].versions[].snapshot.definition.approvalobjectNo
data[].versions[].snapshot.definition.approval.modenone | manualNo
data[].versions[].snapshot.definition.budgetobjectNo
data[].versions[].snapshot.definition.budget.maximumTotalCostUsdnumberNo
data[].versions[].snapshot.metadataobjectYesFree-form metadata object.
data[].versions[].policyFingerprintstringYes
data[].versions[].metadataobjectYesFree-form metadata object.
data[].versions[].publishedAtstringYes
data[].versions[].createdAtstringYesISO 8601 timestamp.
data[].versions[].updatedAtstringYesISO 8601 timestamp.
data[].runsobject[]No
data[].runs[].idstringYesUnique identifier.
data[].runs[].assurancePolicyIdstringYes
data[].runs[].policyVersionIdstringYes
data[].runs[].projectIdstringYesProject ID.
data[].runs[].releaseIdstringYes
data[].runs[].commitShastringYes
data[].runs[].agentIdstringYesAgent ID.
data[].runs[].agentVersionIdstringYes
data[].runs[].statusrunning | passed | failed | blocked | cancelledYesCurrent lifecycle status.
data[].runs[].evidenceReferencesobjectYes
data[].runs[].evidenceReferences.testRunIdsstring[]No
data[].runs[].evidenceReferences.evaluationRunIdsstring[]No
data[].runs[].evidenceReferences.optimizationJobIdsstring[]No
data[].runs[].evidenceobjectYes
data[].runs[].evidence.schemaVersioncomputer_agents_assurance_evidence_v1Yes
data[].runs[].evidence.runIdstringYes
data[].runs[].evidence.policyIdstringYes
data[].runs[].evidence.policyVersionIdstringYes
data[].runs[].evidence.policyFingerprintstringYes
data[].runs[].evidence.subjectobjectYes
data[].runs[].evidence.subject.projectIdstringYesProject ID.
data[].runs[].evidence.subject.releaseIdstringYes
data[].runs[].evidence.subject.commitShastringYes
data[].runs[].evidence.subject.agentIdstringYesAgent ID.
data[].runs[].evidence.subject.agentVersionIdstringYes
data[].runs[].evidence.evaluatedAtstringYes
data[].runs[].evidence.gatesobject[]Yes
data[].runs[].evidence.gates[].idstringYesUnique identifier.
data[].runs[].evidence.gates[].kindtest | evaluation | optimization | budgetYes
data[].runs[].evidence.gates[].statuspassed | failed | pendingYesCurrent lifecycle status.
data[].runs[].evidence.gates[].reasonstringYes
data[].runs[].evidence.gates[].evidenceIdstringYes
data[].runs[].evidence.gates[].evidenceFingerprintstringYes
data[].runs[].evidence.gates[].actualobjectYes
data[].runs[].evidence.gates[].requiredobjectYes
data[].runs[].evidence.evidenceReferencesobjectYes
data[].runs[].evidence.evidenceReferences.testRunIdsstring[]No
data[].runs[].evidence.evidenceReferences.evaluationRunIdsstring[]No
data[].runs[].evidence.evidenceReferences.optimizationJobIdsstring[]No
data[].runs[].evidence.costobjectYes
data[].runs[].evidence.cost.totalCostUsdnumberYes
data[].runs[].evidence.cost.completebooleanYes
data[].runs[].evidence.fingerprintstringYes
data[].runs[].decisionobjectYes
data[].runs[].decision.schemaVersioncomputer_agents_assurance_decision_v1Yes
data[].runs[].decision.runIdstringYes
data[].runs[].decision.outcomepassed | failed | pending_evidence | awaiting_approvalYes
data[].runs[].decision.technicalOutcomepassed | failed | pendingYes
data[].runs[].decision.policyFingerprintstringYes
data[].runs[].decision.evidenceFingerprintstringYes
data[].runs[].decision.approvalobjectYes
data[].runs[].decision.approval.statusnot_required | pending | approvedYesCurrent lifecycle status.
data[].runs[].decision.approval.actorIdstringYes
data[].runs[].decision.approval.actorTypeuser | policyYes
data[].runs[].decision.approval.approvedAtstringYes
data[].runs[].decision.approval.evidenceFingerprintstringYes
data[].runs[].decision.decidedAtstringYes
data[].runs[].decision.fingerprintstringYes
data[].runs[].approvalobjectYes
data[].runs[].approval.approvedByUserIdstringYes
data[].runs[].approval.approvedAtstringYes
data[].runs[].approval.evidenceFingerprintstringYes
data[].runs[].revisionintegerYes
data[].runs[].metadataobjectYesFree-form metadata object.
data[].runs[].createdAtstringYesISO 8601 timestamp.
data[].runs[].updatedAtstringYesISO 8601 timestamp.
data[].runs[].completedAtstringYesISO 8601 timestamp.
data[].runs[].eventsobject[]No
assurancePoliciesobject[]Yes
assurancePolicies[].idstringYesUnique identifier.
assurancePolicies[].projectIdstringYesProject ID.
assurancePolicies[].namestringYesHuman-readable name.
assurancePolicies[].descriptionstringYesHuman-readable description.
assurancePolicies[].statusdraft | active | archivedYesCurrent lifecycle status.
assurancePolicies[].definitionobjectYesAt least one test, evaluation, or optimization gate is required. Gate IDs are unique across all gate kinds.
assurancePolicies[].definition.schemaVersioncomputer_agents_assurance_policy_v2No
assurancePolicies[].definition.testGatesobject[]No
assurancePolicies[].definition.testGates[].idstringNoUnique identifier.
assurancePolicies[].definition.testGates[].testPlanIdstringYes
assurancePolicies[].definition.testGates[].versionIdstringNo
assurancePolicies[].definition.testGates[].requireCommitShabooleanNo
assurancePolicies[].definition.testGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance. Disable only for an explicitly approved legacy/non-release migration policy.
assurancePolicies[].definition.testGates[].maxAgeHoursnumberNo
assurancePolicies[].definition.evaluationGatesobject[]No
assurancePolicies[].definition.evaluationGates[].idstringNoUnique identifier.
assurancePolicies[].definition.evaluationGates[].evaluationIdstringYes
assurancePolicies[].definition.evaluationGates[].versionIdstringNo
assurancePolicies[].definition.evaluationGates[].minimumAverageScorenumberNo
assurancePolicies[].definition.evaluationGates[].minimumPassRatenumberNo
assurancePolicies[].definition.evaluationGates[].requireRunFingerprintbooleanNo
assurancePolicies[].definition.evaluationGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance for the exact Evaluation result set and immutable bindings.
assurancePolicies[].definition.evaluationGates[].requireSignedEvidencebooleanNoRequire the canonical Evaluation evidence fingerprint to carry a cryptographically verified Google Cloud KMS signature.
assurancePolicies[].definition.evaluationGates[].maxAgeHoursnumberNo
assurancePolicies[].definition.optimizationGatesobject[]No
assurancePolicies[].definition.optimizationGates[].idstringNoUnique identifier.
assurancePolicies[].definition.optimizationGates[].agentIdstringYesAgent ID.
assurancePolicies[].definition.optimizationGates[].requireTargetMetbooleanNo
assurancePolicies[].definition.optimizationGates[].requirePublishedCandidatebooleanNo
assurancePolicies[].definition.optimizationGates[].maxAgeHoursnumberNo
assurancePolicies[].definition.approvalobjectNo
assurancePolicies[].definition.approval.modenone | manualNo
assurancePolicies[].definition.budgetobjectNo
assurancePolicies[].definition.budget.maximumTotalCostUsdnumberNo
assurancePolicies[].policyFingerprintstringYes
assurancePolicies[].publishedVersionIdstringYes
assurancePolicies[].metadataobjectYesFree-form metadata object.
assurancePolicies[].createdAtstringYesISO 8601 timestamp.
assurancePolicies[].updatedAtstringYesISO 8601 timestamp.
assurancePolicies[].versionsobject[]No
assurancePolicies[].versions[].idstringYesUnique identifier.
assurancePolicies[].versions[].assurancePolicyIdstringYes
assurancePolicies[].versions[].versionintegerYes
assurancePolicies[].versions[].labelstringYes
assurancePolicies[].versions[].descriptionstringYesHuman-readable description.
assurancePolicies[].versions[].statussaved | published | archivedYesCurrent lifecycle status.
assurancePolicies[].versions[].snapshotobjectYes
assurancePolicies[].versions[].snapshot.namestringYesHuman-readable name.
assurancePolicies[].versions[].snapshot.descriptionstringYesHuman-readable description.
assurancePolicies[].versions[].snapshot.statusdraft | active | archivedYesCurrent lifecycle status.
assurancePolicies[].versions[].snapshot.projectIdstringYesProject ID.
assurancePolicies[].versions[].snapshot.definitionobjectYesAt least one test, evaluation, or optimization gate is required. Gate IDs are unique across all gate kinds.
assurancePolicies[].versions[].snapshot.definition.schemaVersioncomputer_agents_assurance_policy_v2No
assurancePolicies[].versions[].snapshot.definition.testGatesobject[]No
assurancePolicies[].versions[].snapshot.definition.testGates[].idstringNoUnique identifier.
assurancePolicies[].versions[].snapshot.definition.testGates[].testPlanIdstringYes
assurancePolicies[].versions[].snapshot.definition.testGates[].versionIdstringNo
assurancePolicies[].versions[].snapshot.definition.testGates[].requireCommitShabooleanNo
assurancePolicies[].versions[].snapshot.definition.testGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance. Disable only for an explicitly approved legacy/non-release migration policy.
assurancePolicies[].versions[].snapshot.definition.testGates[].maxAgeHoursnumberNo
assurancePolicies[].versions[].snapshot.definition.evaluationGatesobject[]No
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].idstringNoUnique identifier.
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].evaluationIdstringYes
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].versionIdstringNo
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].minimumAverageScorenumberNo
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].minimumPassRatenumberNo
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].requireRunFingerprintbooleanNo
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].requireTrustedEvidencebooleanNoRequire control-plane verified execution-worker provenance for the exact Evaluation result set and immutable bindings.
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].requireSignedEvidencebooleanNoRequire the canonical Evaluation evidence fingerprint to carry a cryptographically verified Google Cloud KMS signature.
assurancePolicies[].versions[].snapshot.definition.evaluationGates[].maxAgeHoursnumberNo
assurancePolicies[].versions[].snapshot.definition.optimizationGatesobject[]No
assurancePolicies[].versions[].snapshot.definition.optimizationGates[].idstringNoUnique identifier.
assurancePolicies[].versions[].snapshot.definition.optimizationGates[].agentIdstringYesAgent ID.
assurancePolicies[].versions[].snapshot.definition.optimizationGates[].requireTargetMetbooleanNo
assurancePolicies[].versions[].snapshot.definition.optimizationGates[].requirePublishedCandidatebooleanNo
assurancePolicies[].versions[].snapshot.definition.optimizationGates[].maxAgeHoursnumberNo
assurancePolicies[].versions[].snapshot.definition.approvalobjectNo
assurancePolicies[].versions[].snapshot.definition.approval.modenone | manualNo
assurancePolicies[].versions[].snapshot.definition.budgetobjectNo
assurancePolicies[].versions[].snapshot.definition.budget.maximumTotalCostUsdnumberNo
assurancePolicies[].versions[].snapshot.metadataobjectYesFree-form metadata object.
assurancePolicies[].versions[].policyFingerprintstringYes
assurancePolicies[].versions[].metadataobjectYesFree-form metadata object.
assurancePolicies[].versions[].publishedAtstringYes
assurancePolicies[].versions[].createdAtstringYesISO 8601 timestamp.
assurancePolicies[].versions[].updatedAtstringYesISO 8601 timestamp.
assurancePolicies[].runsobject[]No
assurancePolicies[].runs[].idstringYesUnique identifier.
assurancePolicies[].runs[].assurancePolicyIdstringYes
assurancePolicies[].runs[].policyVersionIdstringYes
assurancePolicies[].runs[].projectIdstringYesProject ID.
assurancePolicies[].runs[].releaseIdstringYes
assurancePolicies[].runs[].commitShastringYes
assurancePolicies[].runs[].agentIdstringYesAgent ID.
assurancePolicies[].runs[].agentVersionIdstringYes
assurancePolicies[].runs[].statusrunning | passed | failed | blocked | cancelledYesCurrent lifecycle status.
assurancePolicies[].runs[].evidenceReferencesobjectYes
assurancePolicies[].runs[].evidenceReferences.testRunIdsstring[]No
assurancePolicies[].runs[].evidenceReferences.evaluationRunIdsstring[]No
assurancePolicies[].runs[].evidenceReferences.optimizationJobIdsstring[]No
assurancePolicies[].runs[].evidenceobjectYes
assurancePolicies[].runs[].evidence.schemaVersioncomputer_agents_assurance_evidence_v1Yes
assurancePolicies[].runs[].evidence.runIdstringYes
assurancePolicies[].runs[].evidence.policyIdstringYes
assurancePolicies[].runs[].evidence.policyVersionIdstringYes
assurancePolicies[].runs[].evidence.policyFingerprintstringYes
assurancePolicies[].runs[].evidence.subjectobjectYes
assurancePolicies[].runs[].evidence.subject.projectIdstringYesProject ID.
assurancePolicies[].runs[].evidence.subject.releaseIdstringYes
assurancePolicies[].runs[].evidence.subject.commitShastringYes
assurancePolicies[].runs[].evidence.subject.agentIdstringYesAgent ID.
assurancePolicies[].runs[].evidence.subject.agentVersionIdstringYes
assurancePolicies[].runs[].evidence.evaluatedAtstringYes
assurancePolicies[].runs[].evidence.gatesobject[]Yes
assurancePolicies[].runs[].evidence.gates[].idstringYesUnique identifier.
assurancePolicies[].runs[].evidence.gates[].kindtest | evaluation | optimization | budgetYes
assurancePolicies[].runs[].evidence.gates[].statuspassed | failed | pendingYesCurrent lifecycle status.
assurancePolicies[].runs[].evidence.gates[].reasonstringYes
assurancePolicies[].runs[].evidence.gates[].evidenceIdstringYes
assurancePolicies[].runs[].evidence.gates[].evidenceFingerprintstringYes
assurancePolicies[].runs[].evidence.gates[].actualobjectYes
assurancePolicies[].runs[].evidence.gates[].requiredobjectYes
assurancePolicies[].runs[].evidence.evidenceReferencesobjectYes
assurancePolicies[].runs[].evidence.evidenceReferences.testRunIdsstring[]No
assurancePolicies[].runs[].evidence.evidenceReferences.evaluationRunIdsstring[]No
assurancePolicies[].runs[].evidence.evidenceReferences.optimizationJobIdsstring[]No
assurancePolicies[].runs[].evidence.costobjectYes
assurancePolicies[].runs[].evidence.cost.totalCostUsdnumberYes
assurancePolicies[].runs[].evidence.cost.completebooleanYes
assurancePolicies[].runs[].evidence.fingerprintstringYes
assurancePolicies[].runs[].decisionobjectYes
assurancePolicies[].runs[].decision.schemaVersioncomputer_agents_assurance_decision_v1Yes
assurancePolicies[].runs[].decision.runIdstringYes
assurancePolicies[].runs[].decision.outcomepassed | failed | pending_evidence | awaiting_approvalYes
assurancePolicies[].runs[].decision.technicalOutcomepassed | failed | pendingYes
assurancePolicies[].runs[].decision.policyFingerprintstringYes
assurancePolicies[].runs[].decision.evidenceFingerprintstringYes
assurancePolicies[].runs[].decision.approvalobjectYes
assurancePolicies[].runs[].decision.approval.statusnot_required | pending | approvedYesCurrent lifecycle status.
assurancePolicies[].runs[].decision.approval.actorIdstringYes
assurancePolicies[].runs[].decision.approval.actorTypeuser | policyYes
assurancePolicies[].runs[].decision.approval.approvedAtstringYes
assurancePolicies[].runs[].decision.approval.evidenceFingerprintstringYes
assurancePolicies[].runs[].decision.decidedAtstringYes
assurancePolicies[].runs[].decision.fingerprintstringYes
assurancePolicies[].runs[].approvalobjectYes
assurancePolicies[].runs[].approval.approvedByUserIdstringYes
assurancePolicies[].runs[].approval.approvedAtstringYes
assurancePolicies[].runs[].approval.evidenceFingerprintstringYes
assurancePolicies[].runs[].revisionintegerYes
assurancePolicies[].runs[].metadataobjectYesFree-form metadata object.
assurancePolicies[].runs[].createdAtstringYesISO 8601 timestamp.
assurancePolicies[].runs[].updatedAtstringYesISO 8601 timestamp.
assurancePolicies[].runs[].completedAtstringYesISO 8601 timestamp.
assurancePolicies[].runs[].eventsobject[]No
List accessible Assurance Policies
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow