Invoke an immutable saved Function candidate in the Evaluation sandbox
/v1/evaluations/runs/{runId}/function-candidates/{candidateId}/invokeInternal workload endpoint for the exact leased Evaluation run. The control plane verifies the run, case, target version, candidate and objective fingerprints, source-asset digests, invocation contract, and active lease before executing the saved Function snapshot. Candidate code runs non-root in an ephemeral resource-limited container with no network, platform bindings, runtime credentials, or writable root filesystem. It never invokes or changes the production deployment.
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.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| runId | path | string | Yes | — |
| candidateId | path | string | Yes | — |
Body schema
Content type: application/json · Required
| Field | Type | Required | Description |
|---|---|---|---|
| caseId | string | Yes | — |
| method | GET | POST | PUT | PATCH | DELETE | Yes | — |
| path | string | Yes | Workspace-relative file path. |
| body | object | Yes | Exact immutable Evaluation case payload, including any digest-verified inline source assets. |
| executionLease | object | Yes | — |
| executionLease.owner | string | Yes | — |
| executionLease.token | string | Yes | — |
What the API returns
Each response code below includes the documented payload shape for the ACP API.
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | Yes | Current lifecycle status. |
| ok | boolean | Yes | — |
| headers | object | Yes | — |
| body | object | Yes | — |
| candidateId | string | Yes | — |
| candidateVersionId | string | Yes | — |
| candidateFingerprint | string | Yes | — |
| sandboxContractFingerprint | string | Yes | — |
| durationMs | integer | Yes | — |
| execution | object | Yes | — |
| execution.schemaVersion | computer_agents_function_candidate_sandbox_execution_v1 | Yes | — |
| execution.sandboxContractFingerprint | string | Yes | — |
| execution.candidateFingerprint | string | Yes | — |
| execution.imageBuildFingerprint | string | Yes | — |
| execution.runtimeProvider | local_docker | runtime_daemon | Yes | — |
| execution.stdoutBytes | integer | Yes | — |
| execution.stderrBytes | integer | Yes | — |
| execution.stdoutSha256 | string | Yes | — |
| execution.stderrSha256 | string | Yes | — |