Skip to main content
GET
List skills

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Query Parameters

skill_group_id
string<uuid>

Return only the skills filed under this group, which is how a console fills one folder. Answers 404 when the group is not there. Cannot be combined with ungrouped.

ungrouped
boolean

Return only the skills filed under no group. This is the catalog tree's root bucket, and the complement of skill_group_id rather than a client-side slice of the whole catalog.

Return only skills whose name, display title, or description contains this term, case-insensitively. Matched as a literal substring, so % and _ carry no special meaning. A complete skill id also matches that skill. Combines with the group filters, and pages like any other query.

Required string length: 2 - 256
limit
integer

How many skills to return. Defaults to 100, the maximum is 500.

Required range: 1 <= x <= 500
page_token
string

The next_page_token from a previous response. Pass it back with the same filters and limit to read the next page; a token used with a different query is rejected rather than silently skipping rows.

Response

Response body of GET /v1/skills. Paged: read to the end by following next_page_token until it is absent. Each row carries the name and description an agent's prompt discloses, but not the instructions, which are read one version at a time.

Response body of GET /v1/skills. Paged: read to the end by following next_page_token until it is absent. Each row carries the name and description an agent's prompt discloses, but not the instructions, which are read one version at a time.

skills
object[]
required

One page of matching skills, newest first. Soft-deleted skills are omitted.

next_page_token
string

Present when more skills match. Pass it as page_token with the same filters and limit to read the next page. Absent on the last page.