---
title: "Search Skills Route"
method: POST
path: "/skills/search"
---

# Search Skills Route

`POST /skills/search`

## Request

- Base URL: `https://api.goodeye.dev/v1`
- URL: `https://api.goodeye.dev/v1/skills/search`
- Auth: none declared

## Request body

- SearchWorkflowsInput: Natural-language search request over skills visible to the caller.
  - `query` string, required: Natural-language description of the skill you are looking for.
  - `filter` 'mine' | 'all' | 'shared-with-me': Which skills to search: 'mine' for ones you own, 'shared-with-me' for ones shared with you, or 'all' for both.
  - `tag` string, nullable: Restrict results to skills carrying this tag; omit to search every tag.
  - `limit` integer: Maximum number of ranked results to return (1 to 10).

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodeye/apis/goodeye-api.md) · [All operations](https://skmtc.dev/goodeye/apis/goodeye-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodeye/apis/goodeye-api/revisions/547cb8bb6ede?raw)