Get immutable candidate producer context

GET/v1/optimization-campaigns/{campaignId}/attempts/{attemptId}/producer-context

Returns the exact published base snapshot, objective, baseline, and bounded prior-attempt evidence with a canonical context fingerprint. The response is never cached.

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
campaignIdpathstringYesDurable Optimization Campaign ID
attemptIdpathstringYesImmutable Optimization Campaign attempt 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.

200Fingerprinted producer contextapplication/json
FieldTypeRequiredDescription
contextobjectYes—
context.schemaVersioncomputer_agents_optimization_campaign_producer_context_v1Yes—
context.campaignIdstringYes—
context.attemptIdstringYes—
context.attemptNumberintegerYes—
context.contractFingerprintstringYes—
context.objectiveFingerprintstringYes—
context.producerRequestobjectYes—
context.producerRequest.schemaVersioncomputer_agents_optimization_campaign_producer_request_v1Yes—
context.producerRequest.campaignIdstringYes—
context.producerRequest.attemptIdstringYes—
context.producerRequest.attemptNumberintegerYes—
context.producerRequest.targetobjectYes—
context.producerRequest.target.kindfunction | metronomeYes—
context.producerRequest.target.resourceKeystringYes—
context.producerRequest.target.resourceIdstringYes—
context.producerRequest.target.baseVersionIdstringYes—
context.producerRequest.target.baseFingerprintstringYes—
context.producerRequest.objectiveobjectYes—
context.producerRequest.objective.statementstringYes—
context.producerRequest.objective.metricaverage_score | pass_rateYes—
context.producerRequest.objective.targetnumberYes—
context.producerRequest.objective.minimumImprovementnumberYes—
context.producerRequest.objective.maximumRegressionnumberYes—
context.producerRequest.objectiveFingerprintstringYes—
context.producerRequest.producerobjectYes—
context.producerRequest.producer.kindagentYes—
context.producerRequest.producer.adapterIdstringYes—
context.producerRequest.producer.agentIdstringYesAgent ID.
context.producerRequest.producer.agentVersionIdstringYes—
context.producerRequest.producer.environmentIdstringYesComputer ID.
context.producerRequest.constraintsobjectYes—
context.producerRequest.constraints.candidateMustRemainSavedtrueYes—
context.producerRequest.constraints.networkAccessfalseYes—
context.producerRequest.constraints.secretsAccessfalseYes—
context.producerRequest.constraints.maximumSourceSnapshotBytesintegerYes—
context.producerRequest.constraints.maximumCandidateResponseBytesintegerYes—
context.baselineobjectYes—
context.baseline.evaluationRunIdstringYes—
context.baseline.scorenumberYes—
context.baseline.passRatenumberYes—
context.baseobjectYes—
context.base.targetKindfunction | metronomeYes—
context.base.resourceIdstringYes—
context.base.versionIdstringYes—
context.base.versionintegerYes—
context.base.fingerprintstringYes—
context.base.snapshotobjectYes—
context.base.snapshot.namestringNoHuman-readable name.
context.base.snapshot.descriptionstringNoHuman-readable description.
context.base.snapshot.kindfunctionYes—
context.base.snapshot.sourceTypemanual | computer | gitNo—
context.base.snapshot.sourceEnvironmentIdstringNo—
context.base.snapshot.sourcePathstringNoWorkspace-relative file path.
context.base.snapshot.regionstringNo—
context.base.snapshot.runtimestringNo—
context.base.snapshot.authModepublic | privateNo—
context.base.snapshot.customDomainstringNo—
context.base.snapshot.metadataobjectNoVersionable Function metadata. Deployment identity and credentials are rejected.
context.base.snapshot.sourceFilesobject[]Yes—
context.base.snapshot.sourceFiles[].pathstringYesSafe relative versioned source path.
context.base.snapshot.sourceFiles[].namestringYesHuman-readable name.
context.base.snapshot.sourceFiles[].isFolderbooleanYes—
context.base.snapshot.sourceFiles[].sizeintegerYes—
context.base.snapshot.sourceFileContentsobjectYesComplete contents for every non-folder sourceFiles entry.
context.priorAttemptsobject[]Yes—
context.priorAttempts[].attemptIdstringYes—
context.priorAttempts[].attemptNumberintegerYes—
context.priorAttempts[].statusqueued | producing | evaluating | awaiting_assurance | accepted | promoted | rejected | failed | cancelledYesCurrent lifecycle status.
context.priorAttempts[].scorenumberYes—
context.priorAttempts[].passRatenumberYes—
context.priorAttempts[].improvementnumberYes—
context.priorAttempts[].errorstringYes—
context.priorAttempts[].candidateFingerprintstringYes—
context.priorAttempts[].testRunIdstringYes—
context.priorAttempts[].evaluationRunIdstringYes—
context.priorAttempts[].assuranceRunIdstringYes—
context.contextFingerprintstringYes—
409Base changed or attempt is no longer producible
None.
413Exact base exceeds the bounded inline producer context
None.
Get immutable candidate producer context
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow