Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Skills

List the skills

The skills of the workspace, by name: the steps for one kind of job, which every teammate can open besides the skills of its role. A message to a teammate that starts with /name asks it to use that skill.

get/api/v1/skills

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy skills list
MCP tooltroopy_list_skills
Rate limit60 calls in 60 seconds, for each key

Response

200 · application/json
data*array<object>
10 properties
name*string

The skill's name, like cold-email: a message that starts with /cold-email asks a teammate to use it

At most 64 characters

description*string

When to use it: what every teammate's list of skills shows

enabled*boolean

Off: no teammate sees it or opens it

source*enum<string>

person: a person wrote it. teammate: a teammate proposed it, and a person approved it. taught: a person taught it by doing the task once

personteammatetaught

author*object

Who made it: a person, an API key, or the teammate whose proposal a person approved

3 properties
type*enum<string>

personagentapi

id*string
name*string
teammate*string | null

A taught skill: the handle of the teammate whose browser showed it

uses*integer

How many runs used it: a person asked for it with /name, or a teammate opened it

lastUsedAt*string | null

When a run last used it. null when no run did

createdAt*string

ISO 8601 date and time

updatedAt*string

ISO 8601 date and time

Errors

401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.