Skip to main content
GET
Get Skill Proposal

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

proposal_id
string
required

Query Parameters

dataset_id
string<uuid>
required

Dataset UUID the proposal is scoped to. List your datasets via GET /api/v1/datasets to find it.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Response

Successful Response

A single skill-improvement proposal, including before/after procedures.

proposal_id
string
required

Stable proposal identifier.

skill_id
string
default:""

Identifier of the skill being improved.

skill_name
string
default:""

Name of the skill being improved.

status
string
default:proposed

Lifecycle status: 'proposed' or 'applied'.

confidence
number
default:0

Model confidence in the proposed change.

rationale
string
default:""

Why the change was proposed.

model_name
string
default:""

LLM that generated the proposal.

old_procedure
string
default:""

Current skill procedure (before).

proposed_procedure
string
default:""

Proposed skill procedure (after).

runs_used
string[]

SkillRun ids whose failures motivated the proposal.

dataset_scope
string[]

Dataset UUIDs this proposal is scoped to.