List skills
Returns one page of the calling organization’s skills, newest first, following next_page_token until it is absent to read the whole catalog. Soft-deleted skills are omitted. Instructions are not included: attach a skill to an agent and the model receives its description in every turn, and its instructions only when it activates the skill. Narrow the page with skill_group_id for one folder, ungrouped for the skills in no folder, or search for a substring of a name, title, or description, or for a complete skill id.
Authorizations
A Recursion API key, created in the console under API keys.
Query Parameters
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.
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.
2 - 256How many skills to return. Defaults to 100, the maximum is 500.
1 <= x <= 500The 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.