Skip to main content
GET
Rate limit tier: general, 600 requests/min. See Rate limits. Returns one keyset page of a workflow’s optimizations, newest first. Follow next_cursor until it is null. See Pagination. Pass kind to keep one kind: extraction for measured runs, extraction_oneshot for one-shot runs. Omit it to list both. An unknown kind returns 400 VALIDATION_ERROR. Each item has the shape GET …/optimizations/{optimization_id}/ returns, except that every round leaves per_field empty. Read one optimization by id for its per-field scores. The newest item is the workflow’s latest optimization, so there is no separate route for it. An unknown workflow returns 404, as does one in another organization.

Authorizations

Authorization
string
header
required

API key issued from app.anyformat.ai/api-key. Send as Authorization: Bearer <key>.

Path Parameters

workflow_id
string
required

Query Parameters

kind
enum<string> | null

Only optimizations of this kind.

Available options:
extraction,
extraction_oneshot
limit
integer
default:20

Page size, capped at 100.

Required range: 1 <= x <= 100
cursor
string | null

Opaque token from a previous response's next_cursor.

Response

Successful Response

One keyset page of optimizations, newest first.

items
OptimizationV3 · object[]
required

Optimizations on this page, newest first.

next_cursor
string | null

Opaque token to fetch the next page; pass it back as ?cursor=. null on the last page.