---
title: "Start live proof from the final committed source"
method: POST
path: "/v1/projects/{project_id}/onboarding/proof"
tags: ["Onboarding"]
---

# Start live proof from the final committed source

`POST /v1/projects/{project_id}/onboarding/proof`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/projects/{project_id}/onboarding/proof`
- Auth: HTTP bearer

After approval, use the customer's existing official PostHog SDKs to capture analytics after every approved durable success and exceptions at approved failure exits. Agentry provides no browser or server telemetry credential. Test, commit a clean shipped tree, run the source helper with --final, and submit only its snapshot. Attach the returned short-lived runtime marker as the agentry_onboarding_proof PostHog event property while exercising real product paths. Use the separate CI marker header only on trusted Agentry deploy attribution. Neither marker authorizes writes.

## Path parameters

- `project_id` string, required

## Headers

- `If-Match` string, required

## Request body

- OnboardingV3ProofStartRequest
  - `implementation_source_snapshot` OnboardingV3SourceSnapshot, required
    - `git_head_sha` string, nullable, required
    - `source_fingerprint_sha256` string, required
    - `source_fingerprint_algorithm` 'agentry-source-tree-sha256-v1', required

## Response `201`

Proving state plus a one-time PostHog event-property marker and a distinct CI header marker.

- OnboardingV3ProofStartResponse
  - `state` OnboardingV3ProvingState, required
    - `status` 'proving', required
    - `installation_complete` false, required
    - `evidence_status` object, required
      - `historical` 'not_established' | 'historically_observed', required
      - `source` 'pending', required
    - `etag` string, required
    - `next_action` OnboardingV3ProvingNextAction, required
      - `id` 'exercise_and_verify', required
      - `instruction` 'Deploy the approved final source with the CI marker, then exercise every approved real milestone and safe error with the short-lived PostHog proof property, then verify.', required
      - `requires_human` false, required
      - `operation` object, required
        - `method` 'POST', required
        - `path` string, required: Exact project-scoped operation that completes this action after its checklist.
      - `checklist` unknown[], required
        - unknown
      - `completion_condition` 'The returned state has evidence_status.source source_verified, installation_complete true, and next_action null.', required
      - `guide_anchor` 'https://github.com/agentry-sh/agentry/blob/main/INSTALL.md#6-prove-the-deployed-result', required
    - `contract_version` '3', required
    - `project_id` string, required
    - `onboarding_id` string, required
    - `revision` integer, required
    - `plan_sha256` string, required
    - `updated_at` integer, required
    - `implementation_source_snapshot` OnboardingV3SourceSnapshot, required
      - `git_head_sha` string, nullable, required
      - `source_fingerprint_sha256` string, required
      - `source_fingerprint_algorithm` 'agentry-source-tree-sha256-v1', required
    - `proof_session` object, required
      - `proof_session_id` string, required
      - `status` 'open', required
      - `started_at` integer, required
      - `expires_at` integer, required
    - `plan` OnboardingV3Plan, required
      - `business_question` string, required
      - `plan_markdown` string, required: Human-readable actor or interacting actors, entry, complete connected value flow, first value, business result, failures, and deploy rationale. Multi-actor products include the producer/setup side through the consumer result. Never include credentials or raw telemetry.
      - `source_snapshot` OnboardingV3SourceSnapshot, required
        - `git_head_sha` string, nullable, required
        - `source_fingerprint_sha256` string, required
        - `source_fingerprint_algorithm` 'agentry-source-tree-sha256-v1', required
      - `historical_evidence` OnboardingV3HistoricalEvidence, required
        - `status` 'historically_observed', required
        - `source` 'posthog_cloud', required
        - `posthog_project_id` integer, required
        - `observed_at` integer, required
        - `window` object, required
          - `from` integer, required
          - `to` integer, required
        - `query_receipt_sha256` string, required
        - `observations` OnboardingV3HistoricalObservation[], required: Bounded counts, timestamps, signal identifiers, and property identifiers from PostHog. This is non-authorizing historical evidence, never source proof.
          - union
            - object
              - …
            - object
              - …
      - `milestones` OnboardingV3Milestone[], required: Every material durable transition in the selected value flow.
        - `event` string, required: Repository-chosen opaque value; spelling is not an acceptance signal.
        - `meaning` string, required: Durable value progress proved after this target succeeds.
        - `posthog_boundary` 'browser_posthog' | 'server_posthog', required
        - `properties` string[], required
        - `targets` OnboardingV3SourceTarget[], required
          - `file` string, required: Repository-relative shipped source or configuration path.
          - `anchor` string, required: Exact source text locating the outcome boundary in this file.
      - `failures` OnboardingV3Failure[], required
        - `marker` string, required: Repository-chosen opaque value; spelling is not an acceptance signal.
        - `meaning` string, required: Business-impacting failure proved at this exact exit.
        - `posthog_boundary` 'browser_posthog' | 'server_posthog', required
        - `context` string[], required
        - `safe_live_proof` boolean, required
        - `targets` OnboardingV3SourceTarget[], required
          - `file` string, required: Repository-relative shipped source or configuration path.
          - `anchor` string, required: Exact source text locating the outcome boundary in this file.
      - `deploy` OnboardingV3Deploy, required
        - `environment` string, required
        - `sha_source` 'git_head', required
        - `targets` OnboardingV3SourceTarget[], required
          - `file` string, required: Repository-relative shipped source or configuration path.
          - `anchor` string, required: Exact source text locating the outcome boundary in this file.
  - `one_time_markers` object, required
    - `runtime` OnboardingV3RuntimeProofMarker, required
      - `property_name` 'agentry_onboarding_proof', required
      - `value` string, required
      - `environment_variable` 'AGENTRY_ONBOARDING_PROOF', required
      - `browser_session_storage_key` 'agentry_onboarding_proof', required
    - `ci` OnboardingV3CiProofMarker, required
      - `header_name` 'X-Agentry-Onboarding-Proof', required
      - `value` string, required
      - `environment_variable` 'AGENTRY_ONBOARDING_PROOF', required

## Other responses

- `default`: Agent-readable failure with a stable code and recovery action.

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)