Skip to content
Navigation

Update a skill

Update a custom (non-preset) skill owned by the authenticated user.

PUT
https://truememory-api.mvstg.com/skills/{skill_id}
View as Markdown

Authorization

  • HTTPBearerHTTPrequired

Path parameters

  • skill_idstringrequired

Header parameters

  • X-On-Behalf-Ofoptional

    One of the following:

    • string
    • null
  • X-External-User-Idoptional

    One of the following:

    • string
    • null
  • X-App-Idoptional

    One of the following:

    • string
    • null

Request bodyJSONrequired

  • keyoptional

    One of the following:

    • string
    • null
  • nameoptional

    One of the following:

    • string
    • null
  • descriptionoptional

    One of the following:

    • string
    • null
  • promptoptional

    One of the following:

    • string
    • null
  • categoryoptional

    One of the following:

    • string
    • null
  • app_idsoptional

    One of the following:

    • array<string>
    • null
  • iconoptional

    One of the following:

    • string
    • null
  • argument_hintoptional

    One of the following:

    • string
    • null
  • allowed_toolsoptional

    One of the following:

    • array<string>
    • null
  • metadataoptional

    One of the following:

    • object
    • null
  • is_activeoptional

    One of the following:

    • boolean
    • null
  • sort_orderoptional

    One of the following:

    • integer
    • null
  • use_caseoptional

    One of the following:

    • string
    • null
  • detection_patternsoptional

    One of the following:

    • array<string>
    • null
  • licenseoptional

    One of the following:

    • string
    • null
  • compatibilityoptional

    One of the following:

    • string
    • null
  • forked_from_skill_idoptional

    One of the following:

    • string
    • null
  • parent_synced_atoptional

    Fork baseline: set to the preset's updated_at to mark the fork synced (e.g. after a client-side merge). Null clears it.

    One of the following:

    • string
    • null

Returns

200

Successful Response

JSON
  • idstringrequired
  • user_idrequired

    Owner user_id, NULL for presets.

    One of the following:

    • string
    • null
  • app_idsrequired

    Apps this skill is assigned to. NULL means all apps (global/unscoped).

    One of the following:

    • array<string>
    • null
  • keystringrequired
  • namestringrequired
  • descriptionrequired

    One of the following:

    • string
    • null
  • promptstringrequired
  • categoryrequired

    Freeform grouping label (legacy string). Distinct from categories.

    One of the following:

    • string
    • null
  • iconrequired

    One of the following:

    • string
    • null
  • argument_hintrequired

    One of the following:

    • string
    • null
  • allowed_toolsarray ofstringrequired
  • metadataobjectrequired
  • is_presetbooleanrequired
  • is_activebooleanrequired
  • sort_orderintegerrequired
  • forked_from_skill_idrequired

    One of the following:

    • string
    • null
  • usage_countintegerrequired

    Global invocation count, bumped via POST /skills/{id}/usage.

  • last_used_atrequired

    When the skill was last invoked, NULL if never.

    One of the following:

    • string
    • null
  • parent_synced_atrequired

    For forks: the preset updated_at this fork is synced to. The fork is stale when its preset's updated_at is newer. NULL for non-forks.

    One of the following:

    • string
    • null
  • created_atstringrequired
    format: date-time
  • updated_atstringrequired
    format: date-time
  • app_idrequired

    DEPRECATED, read app_ids instead. Legacy single-app scalar derived from app_ids for pre-multi-app consumers: the first app id, or null for all apps. Lossy for multi-app skills.

    One of the following:

    • string
    • null
  • categoriesoptionalarray ofobject

    Category entities assigned via the registry. Returned by the list endpoints, the single-skill reads (user and admin) and PUT /admin/skills/{skill_id}/categories; omitted by writes.

    • idstringrequired
    • namestringrequired
  • use_caseoptional

    When this skill applies, in natural language. Read by skill selection.

    One of the following:

    • string
    • null
  • detection_patternsoptional

    Example utterances that should invoke this skill.

    One of the following:

    • array<string>
    • null
  • licenseoptional

    SKILL.md license: a license name, or the file in the skill that holds it.

    One of the following:

    • string
    • null
  • compatibilityoptional

    SKILL.md compatibility: what the skill needs to run (product, packages, network).

    One of the following:

    • string
    • null

422

Validation Error
JSON
  • detailoptionalarray ofobject
    • locarray ofrequired

      One of the following:

      • string
      • integer
    • msgstringrequired
    • typestringrequired
    • inputoptionalunknown
    • ctxoptionalobject

Type to search…

↑↓ navigate↵ selectEsc close