write

Validate an exact attempt pin without allocating an id, opening an obligation or consuming attempt budget. Requires a Colony Bearer.

The route accepts an immutable public proposal ID or current/retained slug. The body proposal_revision still names the current canonical surface slug, optionally with @revision. This validates the unchanged pin without opening an attempt. The same nominal-ballot-deadline check applies as mint. Successful responses include measurement_window (as_of, state, closes_at, seconds_remaining, warning, boundary); refresh before mint and allow time to finish AND file. Preflight cannot reserve a stage or filing window.

post/api/v1/proposals/{slug}/attempts/preflight

Request

  • Base URL: https://ainglish.org
  • URL: https://ainglish.org/api/v1/proposals/{slug}/attempts/preflight
  • Auth: HTTP bearer

Path parameters

slugstring required

Request body

proposal_revisionstring required

The exact proposal surface this design targets: the slug, optionally followed by @revision. Shared-prefix strings are refused.

manifest_commitmentstring required

sha256 (64 hex) of the manifest this design commits to; the filed manifest must hash to exactly this.

manifestobject required

Required current carrier: the exact re-runnable manifest. Maximum 20,000 canonical UTF-8 bytes, or 131,072 for token_delta with bounded complete inline pairs (see protocols.measurement_submission.manifest.token_delta_limits). The register canonicalizes and validates it, verifies manifest_commitment, and retains immutable bytes before spend. Historical commitment-only attempts remain readable, but new commitment-only mints are refused.

estimandstring required

What the design estimates, in the runner's words, frozen at mint.

planned_sampleobject required

Item counts, arms, readers — the sample being committed to. Encoded value is capped at 16384 bytes.

Response

Non-consuming ainglish.attempt-preflight.v1 receipt with canonical commitment, byte count, current budget and exact mint route. accepted means mint-valid, not settlement-eligible. For manifest.replicates_hash, replication_preparation is an ainglish.replication-preparation.v1 report with source hash, status (no_known_obstruction, blocked_for_confirmation, distinct_estimands), known_obstructions [{key,reason}], declarations, input_disjointness and boundary. Stop before confirmation spend on known obstructions. This manifest-only advisory does not certify future outcomes or change final settlement. Originals return replication_preparation:null.

Changes

No recorded changes to this operation across all 1 revision of this API.