Tests

Start an authored Test asynchronously

Changed on

Validates a runnable leaf Test and starts its Results Value expression. When that expression calls a Code object, the Code runs with the ordinary purpose=automation execution grant it would have received from any other caller. The route returns after scheduling; poll the run resource for evidence, observation, native verdict, or infrastructure failure.

post/api/v2/projects/{projectId}/tests/{testId}/runs

Request

  • Base URL
    https://davinci-app.com
  • Auth
    HTTP bearer

Request body

branchstring

Branch containing the authored Test. Defaults to main.

Response

Test run accepted.

runIdstring uuid required
projectIdstring required
branchNamestring required
testIdstring required
codeObjectIdstring
evaluationRunIdstring uuid
status'queued' | 'starting' | 'running' | 'evaluating' | 'cancelling' | 'completed' | 'failed' | 'cancelled' | 'timed_out' required

completed, failed, cancelled, and timed_out are terminal. failed means the Code execution or evaluation infrastructure failed; a valid low observation still completes and may resolve to a failing Test verdict.

observationnumber

Finite numeric observation committed to the Test's Results Value.

unitstring
evidenceobject

Fixture-defined structured evidence. SYSTEM quality fixtures include transcript, final-tree, usage, and rubric summaries; callers must tolerate additional fixture-specific fields.

createdAtstring date-time required
startedAtstring date-time
completedAtstring date-time
updatedAtstring date-time

Changes

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      endpoint added