assessments

Security assessment lifecycle: draft, validate, start, pause, resume, complete.

List assessment type metadataReturn registry-defined assessment types available to the current user.

Create and start an assessmentCreate an assessment and immediately spawn its workflow agent.

List assessmentsList assessments visible to the caller in their organization.

Attach a new source-code revision (fix_attempt)Attach a new ``fix_attempt`` CodeRevision to an assessment.

List source revisions for an assessmentReturn the append-only CodeRevision series for an assessment.

Attach a direct-upload source-code revision (multipart)Attach a ``fix_attempt`` revision from a directly uploaded archive.

Verify fixes against the assessment's current head revision (free)Spawn ``fix-verify`` against the assessment's current head.

Create a draft assessmentCreate a partial (draft) assessment for later finalization.

List the caller's draftsList draft assessments created by the current user.

Fetch a draft assessmentFetch a single draft by code/public_id.

Update a draft assessmentUpdate mutable fields on a draft assessment.

Delete a draft assessmentPermanently delete a draft assessment.

Start draft validationKick off asynchronous validation of a draft assessment.

Poll draft validation statusFetch current validation status for a draft.

Reset rejected draft for retryTransition a rejected assessment back to ``draft`` state.

Cancel draft validationCancel validation and revert the assessment back to draft.

Start a validated draftFinalize a validated draft and spawn its workflow agent.

Retry a failed assessment startReset a ``start_failed`` assessment back to ``ready`` for retry.

Fetch an assessmentFetch a single assessment by code/public_id.

Update an assessmentUpdate a limited set of mutable fields on an assessment.

Cancel an assessmentCancel an assessment at any stage of its lifecycle.

Archive an assessmentArchive an assessment. Display-only and idempotent.

Unarchive an assessmentRestore an archived assessment to the active views.

Delete assessment source codePermanently delete source code and analysis data for an assessment.

Resume a paused assessmentResume a paused assessment after the underlying issue is fixed.

Fetch blackbox scope review dataFetch scope-review data for a blackbox assessment awaiting approval.

Confirm blackbox scope reviewApply scope decisions and resume a blackbox workflow.

Cancel scope review with partial refundCancel an assessment during scope review and refund the delta.

List agents for an assessmentList the root agent and its direct children for an assessment.

Fetch assessment project stateFetch the full project state for an assessment.

Spawn an agent for an assessmentSpawn an ad-hoc agent against an assessment's project context.

List assessment source filesList source files from an assessment's merged archive.

Fetch a source fileFetch the contents of a single file from the merged archive.

List assessment actorsDerive actor records from credentials plus an anonymous actor.

Recalculate findings countsManually recalculate the cached findings_count for an assessment.

Sync documentation and artifactsSync documentation and artifacts from runner into the API.

Re-fetch the assessment's source archiveRe-pull the assessment's recorded repository at the recorded ref.

List the assessment's source repository treeReturn the file tree of the assessment's recorded source repo at ``ref``.