History

Get a list of all run IDs and timestamps for a user.

Get the list of run IDs for a user.

Get detailed summaries of past runs.

List the published example scenarios available to all users. Load one in full via /saved_scenario using its instance_id.

Get summaries of saved scenarios.

Get the full results of a specific optimization run.

Get the full input state of a saved scenario.

Returns the full input state of a published example, addressed by its slug.

This is the cacheable twin of POST /saved_scenario. Examples are public and immutable between seeds, so this route is a GET keyed entirely by its URL and carries a Cache-Control header — a gateway or CDN can serve it without inspecting a request body or knowing who is asking.

It can only ever return an example: the slug is resolved through the example index and the resolved record's owner is re-checked against the examples account, so a private scenario cannot be served from this path even if the index were wrong. Use POST /saved_scenario for a user's own saved scenarios; that route stays uncached.

Update the name of a specific run.

Delete a specific optimization run.

Delete a saved scenario.

Save a new optimization scenario/problem state.

Rename a saved scenario.

Update an existing scenario with new state/data.

Re-owns runs submitted anonymously so they survive sign-in. Anonymous solves are stored under a throwaway client-generated user id; after the user signs in, the front end posts that id here and every run it owns is reassigned to the authenticated caller. Requires a valid bearer token — the new owner is always the verified token subject, never a value from the request body. Idempotent: re-sending returns claimed 0. Only anonymous-owned runs can be claimed; an id belonging to a signed-in account is rejected.