Skip to main content
GET
/
api
/
v1
/
proposals
/
{proposal_id}
Get Skill Proposal
curl --request GET \
  --url https://api.cognee.ai/api/v1/proposals/{proposal_id} \
  --header 'Authorization: Bearer <token>'
{
  "proposal_id": "<string>",
  "skill_id": "",
  "skill_name": "",
  "status": "proposed",
  "confidence": 0,
  "rationale": "",
  "model_name": "",
  "old_procedure": "",
  "proposed_procedure": "",
  "runs_used": [
    "<string>"
  ],
  "dataset_scope": [
    "<string>"
  ]
}

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.