Get a skill improvement
Poll an improvement until it is done or has failed. See its mode, its result, each field’s rows before and after, and which fields were added, merged, or need an answer. The account that started it and anyone who can edit the Skill (its owner or a workspace editor) can poll it; anyone else gets 404.
Authorizations
API key with the vd_sk_ prefix. Create keys from Settings, API Keys in the dashboard.
Path Parameters
Response
The improvement's current state.
"imp_3f9a1c2b7d4e5f60"
queued, working, validating, done, failed "/v1/skill-improvements/imp_3f9a1c2b7d4e5f60"
The mode it ran in.
fix, add_fields, relearn_details Where it was started: api, mcp, assistant (Igris), web (the web app), brain (the workflow Brain chat), or imported (a past Refine or Re-learn from before improvements were unified).
api, mcp, assistant, web, brain, imported The name of the person who started it.
fields: relearn where the fields live. rerecord: redo the steps.
fields, rerecord The diagnosis it started from.
The check run's diagnosis, when fields are still missing.
True: the new version is live. False: kept as a candidate, the old recipe restored.
Short verdict. running: not finished. improved: the new version is live. kept_old: not better, so the old version stayed live. no_change: nothing needed changing. failed: see error. applied: imported from the old Refine history, applied without a check run.
running, improved, kept_old, no_change, failed, applied True for a past Refine or Re-learn entry imported into this history.
What the engine decided.
The live version when it ended.
The version kept but not made live.

