Invoke an immutable saved Function candidate in the Test sandbox
/v1/test-plans/runs/{runId}/function-candidates/{candidateId}/invokeInternal workload endpoint for the exact leased Test run. The control plane verifies the immutable plan case or step, candidate and objective fingerprints, invocation payload, sandbox contract, organization scope, and active execution lease before running the saved Function snapshot. Candidate code executes in the isolated no-network Function candidate sandbox and never invokes or changes a deployed Function.
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 | — |
| stepId | string | No | Step ID. |
| method | GET | POST | PUT | PATCH | DELETE | Yes | — |
| path | string | Yes | Workspace-relative file path. |
| body | object | Yes | Exact payload from the immutable Test case or topology step. |
| 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 | — |