---
title: "Search files or symbols"
method: GET
path: "/projects/{id}/search"
---

# Search files or symbols

`GET /projects/{id}/search`

## Path parameters

- `id` string, required

## Query parameters

- `type` 'content' | 'symbol', required
- `query` string, required
- `exact` boolean
- `regex` boolean
- `limit` integer

## Response `200`

Search results

- union
  - File[] — Results when type=content
    - `path` string, required
    - `lines` Line[], required
      - `number` integer
      - `content` string
    - `diagnostics` Diagnostic[]
      - `range` Range, required
        - `start` Position, required
          - `line` integer, required
          - `character` integer, required
        - `end` Position, required
          - `line` integer, required
          - `character` integer, required
      - `severity` 1 | 2 | 3 | 4 — 1: Error, 2: Warning, 3: Information, 4: Hint
      - `code` union
        - string
        - integer
      - `codeDescription` CodeDescription
        - `href` string, uri, required
      - `source` string
      - `message` string, required
      - `tags` integer[]
      - `relatedInformation` DiagnosticRelatedInformation[]
        - `location` Location, required
          - `uri` string, uri, required
          - `range` Range, required
            - `start` Position, required
              - …
            - `end` Position, required
              - …
        - `message` string, required
      - `data` object — Additional structured data
  - Symbol[] — Results when type=symbol
    - `name` string
    - `kind` string
    - `location` SymbolLocation
      - `path` string, required
      - `range` Range, required
        - `start` Position, required
          - `line` integer, required
          - `character` integer, required
        - `end` Position, required
          - `line` integer, required
          - `character` integer, required

## Other responses

- `400` — Invalid request
- `404` — Project not found
- `500` — Internal server error

---

[API](https://skmtc.dev/hide-org/apis/hide-api.md) · [All operations](https://skmtc.dev/hide-org/apis/hide-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hide-org/hide-api/revisions/615b2b2a65a4/schema)
