---
title: "POST /v1/doctor"
method: POST
path: "/v1/doctor"
tags: ["tools"]
---

# POST /v1/doctor

`POST /v1/doctor`

## Request

- Base URL: `https://api.pkgseek.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pkgseek.com/v1/doctor`
- Auth: none declared

## Request body

- DoctorRequest
  - `command` string, required
  - `distro` string, nullable

## Response `200`

Static command and portability analysis; input is never executed

- DoctorResult
  - `canonical_name` string, nullable
  - `command` string, required
  - `flags` DoctorFlag[], required
    - `canonical` string, nullable
    - `deprecated` boolean, required
    - `description` LocalizedText
      - `en` string, required
      - `zh` string, nullable
    - `status` string, required
    - `token` string, required
  - `install` KnowledgeResolveResult: Exact tool+distro resolution used before suggesting an installation.
    - `binary_name` string, required
    - `canonical_name` string, required
    - `category` string, required
    - `distro` string, required
    - `gotcha` boolean, required
    - `install_command` string, required
    - `last_verified` string, required
    - `notes` LocalizedText
      - `en` string, required
      - `zh` string, nullable
    - `package_name` string, required
    - `packages` KnowledgePackageMatch[], required
      - `arch` string, required
      - `binary_path` string, nullable
      - `binary_verified` boolean, required
      - `file_indexed` boolean, required
      - `package_name` string, required
      - `release` string, required
      - `repo` string, required
      - `source` string, required
      - `version` string, required
    - `platform` string, required
    - `repo` string, required
    - `source` string, required
    - `summary` LocalizedText, required
      - `en` string, required
      - `zh` string, nullable
    - `tool_id` string, required
    - `verification` KnowledgeFactVerification
      - `binary_matches` integer, required
      - `files_indexed` integer, required
      - `package_matches` integer, required
      - `reconciled_at` string, required
      - `status` string, required
  - `portability` PortabilityDiff[], required
    - `bsd` string, required
    - `bsd_source` string, nullable
    - `gnu` string, required
    - `gnu_source` string, nullable
    - `last_verified` string, required
    - `note` LocalizedText
      - `en` string, required
      - `zh` string, nullable
    - `source` string, required
    - `task` LocalizedText, required
      - `en` string, required
      - `zh` string, nullable
  - `tool_id` string, nullable
  - `warnings` string[], required

## Other responses

- `400`: Invalid or oversized command

---

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