Skills

Update a skill

Updates an installed skill to the catalog's current version. Check update_available first: on a skill that is already current this changes nothing. Updating a skill that isn't installed returns an error.

post/skills/{slug}/update

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/skills/{slug}/update
  • Auth: API key in header Authorization

Path parameters

slugstring required

The skill slug (e.g., "og-image-design").

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Response

Skill updated

objectstring required
idstring required
slugstring required
namestring required
descriptionstring nullable required
categorystring nullable required
tagsstring[] nullable required
versionstring required
creator_namestring nullable required
creator_avatar_urlstring nullable required
install_countinteger required
status'draft' | 'published' | 'archived' required
visibility'public' | 'private' required

private is a skill this account uploaded: only this account sees it, and it is not in the public catalog.

install_statusstring nullable required
installed_versionstring nullable required

The version this account installed. Null unless installed.

update_availableboolean required

True when the catalog version is newer than installed_version: POST /skills/{slug}/update installs it.

external_sourcestring nullable required
external_urlstring nullable required
created_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.