---
title: "Search Registry Entities"
method: GET
path: "/v1/search"
tags: ["Search"]
---

# Search Registry Entities

`GET /v1/search`

Searches prompts, skills, and tools across every project the requester can view. The server retrieves lexical and semantic candidates from the natural-language query, reranks them, and reapplies project access before returning common entity metadata.

## Query parameters

- `q` string, required
- `type` 'prompt' | 'skill' | 'tool'

## Response `200`

Ranked registry search results

- SearchResponse
  - `results` SearchResult[], required
    - `type` 'prompt' | 'skill' | 'tool', required
    - `id` string, uuid, required
    - `project_id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `description` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Missing query or unsupported entity type
- `401` — Unauthorized
- `500` — Search provider or internal failure

---

[API](https://skmtc.net/px0-ai/apis/px0-api.md) · [All operations](https://skmtc.net/px0-ai/apis/px0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/px0-ai/px0-api/revisions/3ed72443989d/schema)