> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Search the workspace

> Search visible tasks, records, and meetings with display-ready result links.

Search visible tasks, records, and meetings with display-ready result links.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `tasks:read`, `records:read`, `meetings:read`.

All three scopes are required even when types narrows the results. Results are relevance-ranked and limited, without pagination. Task visibility and meeting detail restrictions still apply. Record previews are not raw field values.

## Parameters

<ParamField query="q" type="string" required>
  Trimmed query, 2–200 characters.
</ParamField>

<ParamField query="types" type="string">
  Optional comma-separated task,record,meeting. Omit for all. Unknown names are ignored; matching is exact.
</ParamField>

<ParamField query="limit" type="integer">
  Default 24; 1–50.
</ParamField>

## Response

**200** — Top-level `query` and `data`. Results include kind, id, title, subtitle, badge, webUrl, and a task, record, or meeting object. See [search shapes](/api-reference/raycast/models#search-results).

<ResponseExample>
  ```json 200 theme={null}
  {
    "query": "Northlane",
    "data": [
      {
        "kind": "record",
        "id": "record_example",
        "title": "Northlane",
        "subtitle": "Client",
        "badge": "Client",
        "avatarUrl": null,
        "webUrl": "https://app.getkato.io/northlane/o/clients/record_example",
        "record": {
          "objectTypeSlug": "clients",
          "objectTypeName": "Client",
          "icon": null,
          "color": null,
          "meta": []
        }
      }
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error --get \
    "https://api.getkato.io/v1/raycast/search" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
    --data-urlencode "q=Northlane" \
    --data-urlencode "types=record" \
    --data-urlencode "limit=24"
  ```
</RequestExample>


## Related topics

- [Raycast](/integrations/raycast.md)
- [Integrations](/integrations/overview.md)
- [Changelog](/changelog.md)
- [All endpoints](/api-reference/endpoints.md)
- [Google Search Console](/integrations/google-search-console.md)