API reference / Skills
Turn a skill pack on or off
Off, no teammate sees its skills. Needs an owner or admin.
/api/v1/skill-packs/{key}Other ways to call it
troopy packs updateIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
key*stringThe pack, as owner__repo of its GitHub repository, like coreyhaines31__marketingskills
At most 150 characters
Body
application/jsonenabled*booleanResponse
200 · application/jsondata*object14 properties
key*stringThe pack, as owner__repo of its GitHub repository, like coreyhaines31__marketingskills
At most 150 characters
name*stringThe repository's name, like marketingskills
repo*stringowner/repo on GitHub
folder*stringThe folder of the repository that holds the skill folders, or several folders apart by commas; empty for the top
sha*stringThe commit that the pack reads
builtIn*booleanShips with Troopy: it follows Troopy's updates, and can't be removed
enabled*booleanOn: every teammate sees its skills that are on
author*stringlicense*string | nullThe SPDX id of its license, like MIT
stars*integer | nullIts stars on GitHub when it was added or synced
about*stringskills*array<object>4 properties
name*stringThe skill's name, like cold-email: a message that starts with /cold-email asks a teammate to use it
At most 64 characters
description*stringon*booleanTeammates see it: the pack is on, and nobody turned the skill off, and no skill before it has its name
shadowed*booleanOff because a skill of the workspace, or of a pack before it, has its name
warnings*array<string>What Troopy left out when it read the pack, and why
syncedAt*string | null