curl -X POST 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/optimizations/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: optimize-invoices-2026-07-05' \
  -H 'Content-Type: application/json' \
  -d '{"kind": "extraction", "max_rounds": 3}'

from anyformat.sdk import Client

client = Client(api_key="YOUR_API_KEY")

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"

# A measured run, scored against the dataset's ground truth.
optimization = client.start_optimization(
    workflow_id, "extraction", max_rounds=3, idempotency_key="optimize-invoices-2026-07-05"
)

# A one-shot run, which needs no ground truth.
one_shot = client.start_optimization(
    workflow_id, "extraction_oneshot", user_context="The total includes VAT."
)
print(optimization.id, optimization.status)

import { Anyformat } from '@anyformat/sdk';

const af = new Anyformat({ apiKey: 'YOUR_API_KEY' });

const workflowId = '0686bb97-8c30-70f0-8000-97669e000eb8';

// A measured run, scored against the dataset's ground truth.
const optimization = await af.startOptimization(workflowId, {
  kind: 'extraction',
  maxRounds: 3,
  idempotencyKey: 'optimize-invoices-2026-07-05',
});

// A one-shot run, which needs no ground truth.
const oneShot = await af.startOptimization(workflowId, {
  kind: 'extraction_oneshot',
  userContext: 'The total includes VAT.',
});
console.log(optimization.id, optimization.status);

{
  "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4f9",
  "workflow_id": "0686bb97-8c30-70f0-8000-97669e000eb8",
  "kind": "extraction",
  "status": "evaluating",
  "max_rounds": 3,
  "baseline_accuracy": null,
  "best_accuracy": null,
  "result_version_id": null,
  "error": null,
  "rounds": [
    {
      "round_no": 0,
      "version_id": "abcdef1234",
      "matched": 0,
      "mismatched": 0,
      "accuracy": 0.0,
      "accepted": false,
      "note": null,
      "created_at": "2026-07-05T10:00:00Z",
      "per_field": []
    }
  ],
  "created_at": "2026-07-05T10:00:00Z",
  "finished_at": null
}