Skip to main content
GET
Get a Skill improvement

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix. Create keys from Settings, API Keys in the dashboard.

Path Parameters

improvement_id
string
required

Response

The improvement's current state.

improvement_id
string
Example:

"imp_3f9a1c2b7d4e5f60"

status
enum<string>
Available options:
queued,
working,
validating,
done,
failed
status_url
string
Example:

"/v1/skill-improvements/imp_3f9a1c2b7d4e5f60"

skill_id
string
slug
string | null
mode
enum<string>

The mode it ran in.

Available options:
fix,
add_fields,
relearn_details
source
enum<string>

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).

Available options:
api,
mcp,
assistant,
web,
brain,
imported
started_by_name
string | null

The name of the person who started it.

feedback
string | null
strategy
enum<string> | null

fields: relearn where the fields live. rerecord: redo the steps.

Available options:
fields,
rerecord
target_fields
string[]
diagnosis
object | null

The diagnosis it started from.

diagnosis_after
object | null

The check run's diagnosis, when fields are still missing.

fields_before
object
fields_after
object
changes
object[]
improved
boolean | null

True: the new version is live. False: kept as a candidate, the old recipe restored.

result
enum<string>

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.

Available options:
running,
improved,
kept_old,
no_change,
failed,
applied
imported
boolean

True for a past Refine or Re-learn entry imported into this history.

details
object | null

What the engine decided.

recipe_version_before
integer | null
recipe_version
integer | null

The live version when it ended.

candidate_version
integer | null

The version kept but not made live.

outcome
string | null
error
string | null
credits_charged
integer
created_at
string<date-time> | null
updated_at
string<date-time> | null
finished_at
string<date-time> | null
idempotent_replay
boolean