skills

List Skills

List skill metadata available to the caller, optionally ranked by a search query.

Parameters: q (str | None): Optional query used to rank skills by matching terms in their names or descriptions.

Returns: list[SkillCardResponse]: Response-formatted skill cards.

get/api/skills

Query parameters

qstring nullable

Optional ranking query

Response

Successful Response

idstring uuid required

namestring required

descriptionstring required

scope'system' | 'workspace' required

versionstring required

trust'system' | 'workspace' | 'untrusted' required

affordancesstring[] required

resources_availableboolean required

Changes

Changed in 5 of the 85 revisions of this API.195

Jul 17, 2026655778279cb11See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 91 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 17, 202662e8c152aa181See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 15, 2026216311cd30ec3See the full diff
- ●
  deleted the header request parameter Authorization
  request-parameter-removed
- ●
  deleted the header request parameter X-Fleet-User-Id
  request-parameter-removed
- ●
  deleted the header request parameter X-Fleet-Workspace-Id
  request-parameter-removed
Jul 13, 2026f18c4c8586ca63See the full diff
- ●
  removed the optional property detail from the response with the 422 status
  response-optional-property-removed
- ●
  added the new system enum value to the items/scope response property for the response status 200
  response-property-enum-value-added
- ●
  added the new system enum value to the items/trust response property for the response status 200
  response-property-enum-value-added
- ●
  added the new untrusted enum value to the items/trust response property for the response status 200
  response-property-enum-value-added
- ●
  added the new workspace enum value to the items/scope response property for the response status 200
  response-property-enum-value-added
- ●
  added the new workspace enum value to the items/trust response property for the response status 200
  response-property-enum-value-added
- ○
  api operation id list_skills_api_skills_get removed and replaced with list_skills
  api-operation-id-removed
- ○
  added the required property code to the response with the 422 status
  response-required-property-added
- ○
  added the required property message to the response with the 422 status
  response-required-property-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 13, 20261afc045b25c01See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 136 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history