Synthesize samples

Generate labeled samples from the model’s trait definitions and attach them tagged provenance='synthesized' (DR 037). Draft-only. Returns 202 + run id on enqueue; the model enters busy (last_operation.kind='synthesize') and returns to draft with the new samples visible on GET /samples at completion. 409 + X-Run-Id on an in-flight idempotency hit (same sample set + synth_type + effort).

POST /models/{handle}/samples/synthesize

Synthesize samples

cURL

curl --request POST \
  --url https://u22a8.ai/v1/models/{handle}/samples/synthesize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "synth_type": "from_traits",
  "effort": "<string>"
}
'

200

{
  "state": "<string>",
  "run_id": "<string>"
}

Authorizations

Authorization · string · header · required

API key issued in the platform console, sent as Authorization: Bearer <key>.

Path Parameters

handle · string · required

Model handle, e.g. 'u22a8.technical-writing'.

Example:

"u22a8.technical-writing"

Body

application/json

Body for synthesizing samples on a draft model (DR 037).

Draft-only — the generative twin of discovery. Reads the model's trait definitions, generates labeled exemplars through the shared synthesis engine, and attaches them as samples tagged provenance='synthesized'. Returns 202 with a run id on enqueue; 409 with X-Run-Id on an in-flight idempotency hit.

synth_type · string · default: from_traits

Synthesis intent (DR 037). Hosted strategies: from_traits (cold-start exemplars from trait semantics) and diversify (voice-preserving variations of seed samples). enrich is engine-internal (held-out eval pool for bundling) and is rejected (422) on this surface.

effort · string | null

DR 031 effort dial — low|medium|high|xhigh|max. Controls synthesis knobs (synth model, sample counts, thinking budget). null uses the default effort level.

Response

200

application/json

Successful Response

Response from POST /v1/models/{handle}/train.

state · string · required

Current model state after the call.

Examples:

"busy"

"ready"

run_id · string | null

Newly enqueued run id, or the matching existing run id on an idempotent hit. null when state == 'ready' and no re-optimization was requested (no run was queued).