curl "https://app.runtm.com/api/cloud/agent-directives:facets?type_family=skill" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api skills facets
runtm-api mcp facets --template tmpl_abc123
{
"facets": [
{
"key": "team",
"values": [
{"value": "gtm", "count": 7},
{"value": "platform", "count": 3}
]
}
]
}
Skills
Directive Facets
Aggregate label keys and values across directives
GET
/
api
/
agent-directives:facets
curl "https://app.runtm.com/api/cloud/agent-directives:facets?type_family=skill" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api skills facets
runtm-api mcp facets --template tmpl_abc123
{
"facets": [
{
"key": "team",
"values": [
{"value": "gtm", "count": 7},
{"value": "platform", "count": 3}
]
}
]
}
Returns the label keys and values in use across the org’s directives, with counts. Use it to discover what labels exist before filtering a list by one. The same scope filters as List Directives apply.
Required scope:
context:read
Query Parameters
string
default:"skill"
skill, mcp, doc, network, allowlist, or hook.string
Scope to directives attached to one repo.
string
Scope to directives attached to one template.
string[]
Pre-filter by label, repeated as
?labels=key:value.Response
array
{key, values: [{value, count}]} per label key.curl "https://app.runtm.com/api/cloud/agent-directives:facets?type_family=skill" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api skills facets
runtm-api mcp facets --template tmpl_abc123
{
"facets": [
{
"key": "team",
"values": [
{"value": "gtm", "count": 7},
{"value": "platform", "count": 3}
]
}
]
}