SIsignificant-gravitas
v2
skill-learning
skill-learning
private

Edit Skill

Changed on

Apply the owner's correction now; later automated changes become proposals unless keep_auto_improve is set.

A content-check block is a domain outcome, not a transport error: the response is 200 with status == "blocked_content" and only the pattern class and ordinal step, so the client keeps the draft and shows the reason without ever echoing the blocked value.

post/api/skill-learning/skills/{name}/edit

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

namestring required

Skill slug

Query parameters

expert_idstring nullable

Expert scope; omit for personal

Request body

descriptionstring required
bodystring required
triggersstring[]
keep_auto_improveboolean
allowed_pattern_classesstring[]
expected_version_idstring nullable

The current version's id when editing began; null only for a skill with no tracked version. A different current version at save time is a conflict and the edit is not applied.

Response

Successful Response

statusstring required
status_labelstring required
reasonstring
pattern_classstring nullable
blocked_stepstring nullable

Changes