---
title: "Ranked fuzzy search"
method: GET
path: "/v1/search"
tags: ["Search"]
---

# Ranked fuzzy search

`GET /v1/search`

Typo-tolerant search across pages, folders, datasets, connectors, people, schedules, crew, and alerts. Same engine as the Home Cmd+K palette. Personal tokens may pass `workspace` to scope; workspace Agent tokens (`sot_`) are pinned to their workspace and require `artifacts:read`.

## Query parameters

- `q` string, required
- `groups` string
- `limit` integer
- `workspace` string

## Response `200`

Grouped search hits

- object
  - `query` string
  - `artifacts` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `folders` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `datasets` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `connectors` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `people` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `schedules` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `crew` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number
  - `alerts` SearchHit[]
    - `kind` 'artifact' | 'folder' | 'dataset' | 'connector' | 'person' | 'schedule' | 'crew' | 'alert'
    - `id` string
    - `title` string
    - `subtitle` string
    - `slug` string
    - `artifactType` string
    - `views` integer
    - `owner` string
    - `thumb` string
    - `avatar` string
    - `badge` string
    - `score` number

## Other responses

- `401` — Authentication required
- `403` — Access denied

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/revisions/804359ead65a/schema)