リファレンス

すべてのLockpick API操作について、その権限、入力、応答を示します。APIから自動生成しています。バージョン1、ベータ版です。

バージョン1、ベータ版です。すべてのパスは /api/cli/v1 から始まります。すべてのリクエストは、キーをベアラートークンとして送ります。すべての応答は { data, error } です。説明全体は OpenAPI 3.1 でも公開しています。

エージェントAPI

ホスト型MCPツールの裏で動くサーバーの操作です。新しい連携では、これらを使ってください。lockpick_wait_for_scan は GET /agent/scans/{scanId} を繰り返し呼び出します。lockpick_evaluate_scan は同じスキャンを読み取り、クライアント側で評価ポリシーを適用します。この2つの組み合わせツールには、個別のHTTPエンドポイントはありません。スクリプトでは、スキャンの状態を確認し続け、完了時刻、カバレッジ、未解決の検出事項の数をお使いのポリシーで評価できます。

GET /agent/me

このキーのユーザー、ワークスペース、スコープ、期限、そして開始できる操作です。

権限: read
MCPツール: lockpick_whoami

data

項目	型	必ず含まれる
`user`	オブジェクト	はい
`workspace`	オブジェクト	はい
`credential`	オブジェクト	はい
`capabilities`	オブジェクト	はい

GET /agent/allowance

今月の無料スキャンの残り、その再設定日、クレジットです。

権限: read
MCPツール: lockpick_get_allowance

data

項目	型	必ず含まれる
`accessSource`	`community`、`stripe`（旧請求の値）、`pilot`（旧、内部用）、`none`	はい
`accountingMode`	`pilot`（旧、内部用）、`credits`（旧、内部用）、`unmetered`	はい
`pulse`	オブジェクト	はい
`deep`	オブジェクト	はい
`creditBalance`	整数または null	はい
`freeSiteId`	文字列または null	はい
`freeSiteVisible`	真偽値	はい
`canSwitchFreeSite`	真偽値	はい

GET /agent/monitor

最新のセキュリティ情報を確認し、許可されたサイトとの一致を説明します。

権限: read
MCPツール: lockpick_monitor

クエリ

項目	型	必須
`view`	`latest`、`sites`、`exploited`、`following`	いいえ
`kind`	`all`、`vulnerability`、`malicious_package`	いいえ
`q`	文字列	いいえ
`ecosystem`	`all`、`npm`、`pypi`、`composer`、`go`、`rubygems`、`maven`、`wordpress`	いいえ
`severity`	`all`、`critical`、`high`、`medium`、`low`、`unknown`	いいえ
`days`	数値	いいえ
`cursor`	文字列	いいえ
`limit`	整数	いいえ
`siteId`	文字列	いいえ
`advisoryId`	文字列	いいえ

data

項目	型	必ず含まれる
`items`	オブジェクトのリスト	はい
`nextCursor`	文字列または null	はい
`limitations`	文字列のリスト	はい

各項目

項目	型	必ず含まれる
`id`	文字列	はい
`title`	文字列	はい
`source`	文字列	はい
`kind`	`vulnerability`、`malicious_package`	はい
`severity`	`critical`、`high`、`medium`、`low`、`unknown`	はい
`provenance`	オブジェクトのリスト	はい
`withdrawnAt`	文字列または null	いいえ
`publishedAt`	文字列	はい
`exploited`	真偽値	はい
`ids`	文字列のリスト	はい
`tech`	オブジェクトのリスト	はい
`epss`	オブジェクトまたは null	いいえ
`cvss`	オブジェクトまたは null	いいえ
`attribution`	文字列または null	はい
`references`	文字列のリスト	はい
`packages`	オブジェクトのリスト	はい
`sites`	オブジェクトのリスト	はい

GET /agent/sites

最新のスキャンとともに、サイトのページを返します。

権限: read
MCPツール: lockpick_list_sites

クエリ

項目	型	必須
`limit`	整数	いいえ
`cursor`	文字列	いいえ

data

項目	型	必ず含まれる
`items`	オブジェクトのリスト	はい
`nextCursor`	文字列または null	はい

各項目

項目	型	必ず含まれる
`id`	文字列	はい
`name`	文字列	はい
`status`	文字列	はい
`baseDomain`	文字列または null	はい
`latestPulse`	オブジェクトまたは null	はい
`latestDeep`	オブジェクトまたは null	はい
`latestBox`	オブジェクトまたは null	はい
`webPath`	文字列	はい
`webUrl`	文字列	はい

POST /agent/sites

サイトを追加します。同じアドレスのサイトがあれば、それを返します。

権限: sites
MCPツール: lockpick_add_site

本文

項目	型	必須
`url`	文字列	はい
`name`	文字列	いいえ
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`site`	オブジェクト	はい
`created`	真偽値	はい

GET /agent/sites/{siteId}/status

1つのサイトの状態です。最新のスキャンと、次に行うべきことを含みます。

権限: read
MCPツール: lockpick_site_status

data

項目	型	必ず含まれる
`site`	オブジェクト	はい
`latestPulse`	オブジェクトまたは null	はい
`latestDeep`	オブジェクトまたは null	はい
`latestBox`	オブジェクトまたは null	はい
`lastComparison`	オブジェクトまたは null	はい
`caveats`	文字列のリスト	はい
`fixes`	オブジェクトまたは null	いいえ
`relevant`	オブジェクトのリスト	いいえ
`relevantTotal`	整数	いいえ

GET /agent/sites/{siteId}/history

サイトのセキュリティ履歴: スキャンの深さごとのスコアの推移（エンジンが変わった箇所で区切り）、未解決の検出事項の推移、修正、再発、修正までの時間の中央値。

権限: read
MCPツール: lockpick_get_site_history

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`scores`	オブジェクトのリスト	はい
`findings`	オブジェクト	はい

POST /agent/sites/{siteId}/dependencies

サイトが使うパッケージ名と正確なバージョンを送ります。コードは送りません。それらに影響するアドバイザリを読み取ります。

権限: sites
MCPツール: lockpick_send_dependencies

本文

項目	型	必須
`inventory`	オブジェクト	いいえ
`packages`	オブジェクトのリスト	はい
`sources`	list of `package-lock.json`, `npm-shrinkwrap.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lock`, `bun.lockb`, `requirements.txt`, `poetry.lock`, `uv.lock`, `Pipfile.lock`, `pdm.lock`, `composer.lock`, `go.mod`, `Gemfile.lock`, `gems.locked`, `pom.xml`, `gradle.lockfile`, `buildscript-gradle.lockfile`, `build.gradle`, `build.gradle.kts`, `Cargo.lock`, `packages.lock.json`, `pubspec.lock`, `mix.lock`, `Package.resolved`	はい
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`receivedAt`	文字列または null	はい
`sources`	list of `package-lock.json`, `npm-shrinkwrap.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lock`, `bun.lockb`, `requirements.txt`, `poetry.lock`, `uv.lock`, `Pipfile.lock`, `pdm.lock`, `composer.lock`, `go.mod`, `Gemfile.lock`, `gems.locked`, `pom.xml`, `gradle.lockfile`, `buildscript-gradle.lockfile`, `build.gradle`, `build.gradle.kts`, `Cargo.lock`, `packages.lock.json`, `pubspec.lock`, `mix.lock`, `Package.resolved`	はい
`packageCount`	整数	はい
`affectsYouCount`	整数	はい
`affectsYou`	オブジェクトのリスト	はい
`webUrl`	文字列	はい

GET /agent/sites/{siteId}/github

サイトの GitHub リンクです。リポジトリ、ブランチ、ロックファイル、最終読み取り、プルリクエストコメントと、呼び出し元の GitHub リストが有効かどうかを返します。

権限: read
MCPツール: lockpick_get_github_link

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`available`	真偽値	はい
`canManage`	真偽値	はい
`linked`	オブジェクト、または null	はい
`lastRead`	オブジェクト、または null	はい
`pullRequestComments`	オブジェクト、または null	はい
`authorization`	オブジェクト	はい
`webUrl`	文字列	はい

GET /agent/github/repositories

このワークスペースにおける呼び出し元自身の GitHub リストにあるリポジトリです。リンクできるのはこれらだけです。

権限: read
MCPツール: lockpick_list_github_repositories

クエリ

項目	型	必須
`search`	文字列	いいえ
`limit`	整数	いいえ

data

項目	型	必ず含まれる
`authorization`	オブジェクト	はい
`items`	オブジェクトのリスト	はい
`matched`	整数	はい
`truncated`	真偽値	はい

各項目

項目	型	必ず含まれる
`repository`	文字列	はい
`defaultBranch`	文字列	はい
`private`	真偽値	はい

POST /agent/sites/{siteId}/github

呼び出し元自身の GitHub リストにあるリポジトリにサイトをリンクするか、本人が承認するページを取得します。

権限: sites
MCPツール: lockpick_link_github_repository

本文

項目	型	必須
`repository`	文字列	はい
`ref`	文字列	いいえ
`lockfiles`	文字列または文字列のリスト	いいえ
`pullRequestComments`	`on`, `off`	いいえ

GET /agent/github/link-requests/{requestId}

本人を待っている GitHub リンクの状況です。

権限: read
MCPツール: lockpick_get_github_link_request

data

項目	型	必ず含まれる
`requestId`	文字列	はい
`siteId`	文字列	はい
`repository`	文字列	はい
`state`	`pending`、`authorizing`、`linked`、`not_reachable`、`declined`、`failed`、`expired`	はい
`expiresAt`	文字列	はい
`link`	オブジェクト、または null	はい

DELETE /agent/sites/{siteId}/github

サイトの GitHub リポジトリのリンクを解除し、ロックファイルの読み取り結果を破棄します。

権限: sites
MCPツール: lockpick_unlink_github_repository

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`unlinked`	真偽値	はい

POST /agent/sites/{siteId}/github/pull-request-comments

サイトにリンクされたリポジトリについて、Deep のプルリクエストセキュリティコメントをオンまたはオフにします。

権限: sites
MCPツール: lockpick_set_github_pr_comments

本文

項目	型	必須
`enabled`	真偽値	はい

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`available`	真偽値	はい
`canManage`	真偽値	はい
`linked`	オブジェクト、または null	はい
`lastRead`	オブジェクト、または null	はい
`pullRequestComments`	オブジェクト、または null	はい
`authorization`	オブジェクト	はい
`webUrl`	文字列	はい

GET /agent/sites/{siteId}/schedules

サイトのPulseとDeepの自動チェックと、プランで選べる頻度です。

権限: read
MCPツール: lockpick_get_schedules

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`enabled`	真偽値	はい
`allowed`	オブジェクト	はい
`pulse`	オブジェクトまたは null	はい
`deep`	オブジェクトまたは null	はい
`webUrl`	文字列	はい

POST /agent/sites/{siteId}/schedules/pulse

プランで選べる頻度の範囲で、サイトのPulseの自動チェックを設定、変更、または再開します。

権限: pulse
MCPツール: lockpick_set_pulse_schedule

本文

項目	型	必須
`cadence`	`daily`, `weekly`, `monthly`	いいえ
`runHourUtc`	整数または null	いいえ

data

項目	型	必ず含まれる
`scheduleId`	文字列	はい
`siteId`	文字列	はい
`depth`	`pulse`, `deep`	はい
`status`	`active`, `paused`, `archived`	はい
`cadence`	`daily`, `weekly`, `monthly`	はい
`runHourUtc`	整数または null	はい
`nextRunAt`	文字列	はい
`consentUntil`	文字列	はい
`lastOutcome`	文字列または null	はい

POST /agent/sites/{siteId}/schedules/pulse/pause

サイトのPulseの自動チェックを一時停止します。

権限: pulse
MCPツール: lockpick_pause_pulse_schedule

data

項目	型	必ず含まれる
`scheduleId`	文字列	はい
`siteId`	文字列	はい
`depth`	`pulse`, `deep`	はい
`status`	`active`, `paused`, `archived`	はい
`cadence`	`daily`, `weekly`, `monthly`	はい
`runHourUtc`	整数または null	はい
`nextRunAt`	文字列	はい
`consentUntil`	文字列	はい
`lastOutcome`	文字列または null	はい

POST /agent/sites/{siteId}/schedules/deep

サイトのDeepの自動チェックの設定、変更、または再開を準備し、本人が承認するためのリンクを取得します。

権限: deep
MCPツール: lockpick_prepare_deep_schedule

本文

項目	型	必須
`cadence`	`daily`, `weekly`, `monthly`	いいえ
`runHourUtc`	整数または null	いいえ

data

項目	型	必ず含まれる
`requestId`	文字列	はい
`siteId`	文字列	はい
`depth`	文字列	はい
`cadence`	`daily`, `weekly`, `monthly`	はい
`runHourUtc`	整数または null	はい
`approvalUrl`	文字列	はい
`expiresAt`	文字列	はい
`pollAfterSeconds`	整数	はい

POST /agent/sites/{siteId}/schedules/deep/pause

サイトのDeepの自動チェックを一時停止します。

権限: deep
MCPツール: lockpick_pause_deep_schedule

data

項目	型	必ず含まれる
`scheduleId`	文字列	はい
`siteId`	文字列	はい
`depth`	`pulse`, `deep`	はい
`status`	`active`, `paused`, `archived`	はい
`cadence`	`daily`, `weekly`, `monthly`	はい
`runHourUtc`	整数または null	はい
`nextRunAt`	文字列	はい
`consentUntil`	文字列	はい
`lastOutcome`	文字列または null	はい

GET /agent/schedule-requests/{requestId}

本人を待っているDeepの自動チェックの状況です。

権限: read
MCPツール: lockpick_get_schedule_request

data

項目	型	必ず含まれる
`requestId`	文字列	はい
`siteId`	文字列	はい
`depth`	文字列	はい
`cadence`	`daily`, `weekly`, `monthly`	はい
`runHourUtc`	整数または null	はい
`state`	`pending`, `approved`, `declined`, `failed`, `expired`	はい
`expiresAt`	文字列	はい
`failure`	文字列または null	はい
`schedule`	オブジェクトまたは null	はい

GET /agent/sites/{siteId}/shares

有効な公開共有リンクがある、サイトのPulseの結果です。

権限: read
MCPツール: lockpick_list_shares

data

項目	型	必ず含まれる
`siteId`	文字列	はい
`shares`	オブジェクトのリスト	はい

POST /agent/scans/{scanId}/share

完了したPulseの結果を公開リンクで公開するか、そのリンクを置き換えます。

権限: pulse
MCPツール: lockpick_share_scan

本文

項目	型	必須
`replace`	真偽値	いいえ

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`url`	文字列または null	はい
`createdAt`	文字列	はい

DELETE /agent/scans/{scanId}/share

Pulseの結果の共有を停止します。その公開リンクは使えなくなります。

権限: pulse
MCPツール: lockpick_unshare_scan

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`unshared`	真偽値	はい

POST /agent/sites/{siteId}/pulse

サイトでPulseを開始します。

権限: pulse
MCPツール: lockpick_start_pulse

本文

項目	型	必須
`idempotencyKey`	文字列	はい
`baselineScanId`	文字列	いいえ

data

項目	型	必ず含まれる
`scan`	オブジェクト	はい
`charged`	オブジェクト	はい
`allowance`	オブジェクト	はい
`replayed`	真偽値	はい

POST /agent/sites/{siteId}/deep-verifications

Deepスキャンの前に、DNSまたはファイルによる所有証明を発行します。

権限: deep
MCPツール: lockpick_start_deep_verification

本文

項目	型	必須
`method`	`dns`、`file`、`meta`	はい
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`verificationId`	文字列	はい
`siteId`	文字列	はい
`origin`	文字列	はい
`method`	`dns`、`file`、`meta`	はい
`state`	`pending`、`verified`、`expired`、`exhausted`、`revoked`	はい
`expiresAt`	文字列	はい
`verifiedUntil`	文字列または null	はい
`attemptsRemaining`	整数	はい
`retryAfterSeconds`	整数または null	はい
`value`	文字列	はい
`location`	文字列	はい

POST /agent/sites/{siteId}/deep-verifications/{verificationId}/verify

公開された所有証明を確認します。確認するたびに、証明の試行回数を1回使います。

権限: deep
MCPツール: lockpick_check_deep_verification

data

項目	型	必ず含まれる
`verificationId`	文字列	はい
`siteId`	文字列	はい
`origin`	文字列	はい
`method`	`dns`、`file`、`meta`	はい
`state`	`pending`、`verified`、`expired`、`exhausted`、`revoked`	はい
`expiresAt`	文字列	はい
`verifiedUntil`	文字列または null	はい
`attemptsRemaining`	整数	はい
`retryAfterSeconds`	整数または null	はい

POST /agent/sites/{siteId}/deep-operations

Deepスキャンを準備し、本人が承認するためのリンクを取得します。

権限: deep
MCPツール: lockpick_prepare_deep

本文

項目	型	必須
`verificationId`	文字列	はい
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`operationId`	文字列	はい
`siteId`	文字列	はい
`origin`	文字列	はい
`assessmentLevel`	文字列	はい
`verificationId`	文字列	はい
`cost`	オブジェクト	はい
`allowance`	オブジェクト	はい
`approvalState`	`pending`、`approved`、`expired`、`denied`	はい
`approvalUrl`	文字列	はい
`expiresAt`	文字列	はい

POST /agent/deep-operations/{operationId}/start

本人が承認したDeepスキャンを開始します。

権限: deep
MCPツール: lockpick_start_deep

data

項目	型	必ず含まれる
`scan`	オブジェクト	はい
`charged`	オブジェクト	はい
`allowance`	オブジェクト	はい
`replayed`	真偽値	はい

POST /agent/free-site-switch

今月の無料Pulseを別のサイトに移すため、サイトを1つ削除します。

権限: sites と pulse
MCPツール: lockpick_switch_free_site

本文

項目	型	必須
`removeSiteId`	文字列	はい
`checkId`	文字列	いいえ
`idempotencyKey`	文字列	はい
`confirmRemoval`	真偽値	はい

data

項目	型	必ず含まれる
`removedSiteId`	文字列	はい
`removedSiteHost`	文字列	はい
`replacementSiteId`	文字列または null	はい
`allowance`	オブジェクト	はい
`restoreUrl`	文字列	はい
`startedScanId`	文字列または null	はい
`charged`	オブジェクト	はい
`replayed`	真偽値	はい

GET /agent/scans

スキャンのページを、新しい順にフィルターして返します。

権限: read
MCPツール: lockpick_list_scans

クエリ

項目	型	必須
`siteId`	文字列	いいえ
`kind`	`pulse`、`box`（Deep、旧名称）	いいえ
`assessmentLevel`	`pulse`、`standard`、`deep`	いいえ
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	いいえ
`limit`	整数	いいえ
`cursor`	文字列	いいえ

data

項目	型	必ず含まれる
`items`	オブジェクトのリスト	はい
`nextCursor`	文字列または null	はい

各項目

項目	型	必ず含まれる
`id`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`projectId`	文字列	はい
`target`	文字列	はい
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	はい
`mode`	`autonomous`、`authenticated`、`active`、または null	はい
`createdAt`	文字列または null	はい
`finishedAt`	文字列または null	はい
`webPath`	文字列	はい
`assessmentLevel`	`pulse`、`standard`、`deep`、または null	はい
`headline`	オブジェクト	はい
`webUrl`	文字列	はい
`suggestedPollAfterSeconds`	整数または null	はい

GET /agent/scans/{scanId}

1つのスキャンを、その状態と見出しとともに返します。

権限: read
MCPツール: lockpick_get_scan

data

項目	型	必ず含まれる
`id`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`projectId`	文字列	はい
`target`	文字列	はい
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	はい
`mode`	`autonomous`、`authenticated`、`active`、または null	はい
`createdAt`	文字列または null	はい
`finishedAt`	文字列または null	はい
`webPath`	文字列	はい
`assessmentLevel`	`pulse`、`standard`、`deep`、または null	はい
`headline`	オブジェクト	はい
`webUrl`	文字列	はい
`suggestedPollAfterSeconds`	整数または null	はい
`docsUrl`	文字列	いいえ
`dismissals`	オブジェクト	いいえ
`baselineRunId`	文字列または null	はい
`open`	オブジェクト	はい
`findingCount`	整数	はい
`progress`	オブジェクトまたは null	はい
`coverage`	オブジェクト	はい
`caveats`	文字列のリスト	はい
`outcome`	オブジェクトまたは null	はい
`exposureCheck`	オブジェクト	いいえ
`coverageReceipt`	オブジェクト	いいえ

GET /agent/scans/{scanId}/findings

スキャンの検出事項のページです。

権限: read
MCPツール: lockpick_list_findings
x-lockpick-agent-features: finding-code を送ると、各検出結果の code（LP- と 6 文字、Web レポートの表示と同じ）を受け取れます。このヘッダーがない場合、回答に code は含まれず、古いクライアントが想定する形のままです。

クエリ

項目	型	必須
`state`	`attention`、`information`、`unknown`、`pass`	いいえ
`severity`	`critical`、`high`、`medium`、`low`、`info`	いいえ
`all`	真偽値、または `true`、`false`	いいえ
`limit`	整数	いいえ
`cursor`	文字列	いいえ

data

項目	型	必ず含まれる
`items`	オブジェクトのリスト	はい
`nextCursor`	文字列または null	はい

各項目

項目	型	必ず含まれる
`dismissal`	オブジェクト	いいえ
`id`	文字列	はい
`code`	文字列	いいえ
`runId`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`severity`	`critical`、`high`、`medium`、`low`、`info`	はい
`state`	`attention`、`information`、`unknown`、`pass`	はい
`category`	文字列	はい
`title`	文字列	はい
`meaning`	文字列	はい
`fix`	文字列または null	はい
`confidence`	文字列	はい
`evidence`	文字列のリスト	はい
`sources`	文字列のリスト	はい
`steps`	文字列のリスト	はい
`webPath`	文字列	はい
`webUrl`	文字列	はい
`evidenceTrust`	文字列	はい
`evidenceTruncated`	真偽値	はい
`verdict`	`confirmed`、`needs_review`、`not_actionable`、または null	いいえ
`certainty`	`high`、`medium`、`low`、または null	いいえ
`exploitability`	`direct`、`conditional`、`hygiene`、`none`、または null	いいえ
`proof`	オブジェクトまたは null	いいえ
`proofGap`	文字列または null	いいえ
`urgency`	`now`、`week`、`later`、`none`	いいえ
`howSure`	`confirmed`、`likely`、`possible`、または null	いいえ
`lifecycle`	オブジェクトまたは null	いいえ

GET /agent/scans/{scanId}/findings/{findingId}

1つの検出事項を、秘匿された証拠とともに返します。

権限: read
MCPツール: lockpick_get_finding
x-lockpick-agent-features: finding-code を送ると、各検出結果の code（LP- と 6 文字、Web レポートの表示と同じ）を受け取れます。このヘッダーがない場合、回答に code は含まれず、古いクライアントが想定する形のままです。

data

項目	型	必ず含まれる
`dismissal`	オブジェクト	いいえ
`id`	文字列	はい
`code`	文字列	いいえ
`runId`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`severity`	`critical`、`high`、`medium`、`low`、`info`	はい
`state`	`attention`、`information`、`unknown`、`pass`	はい
`category`	文字列	はい
`title`	文字列	はい
`meaning`	文字列	はい
`fix`	文字列または null	はい
`confidence`	文字列	はい
`evidence`	文字列のリスト	はい
`sources`	文字列のリスト	はい
`steps`	文字列のリスト	はい
`webPath`	文字列	はい
`webUrl`	文字列	はい
`evidenceTrust`	文字列	はい
`evidenceTruncated`	真偽値	はい
`verdict`	`confirmed`、`needs_review`、`not_actionable`、または null	いいえ
`certainty`	`high`、`medium`、`low`、または null	いいえ
`exploitability`	`direct`、`conditional`、`hygiene`、`none`、または null	いいえ
`proof`	オブジェクトまたは null	いいえ
`proofGap`	文字列または null	いいえ
`urgency`	`now`、`week`、`later`、`none`	いいえ
`howSure`	`confirmed`、`likely`、`possible`、または null	いいえ
`lifecycle`	オブジェクトまたは null	いいえ

GET /agent/scans/{scanId}/repair-brief

スキャンの修正ブリーフの一部です。

権限: read
MCPツール: lockpick_get_repair_brief

クエリ

項目	型	必須
`findingId`	文字列	いいえ
`agent`	`claude-code`、`codex`、`cursor`、`vscode`、`opencode`、`lovable`、`bolt`、`replit`、`v0`	いいえ
`cursor`	文字列	いいえ

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`findingIds`	文字列のリスト	はい
`saved`	真偽値	はい
`markdown`	文字列	はい
`nextCursor`	文字列または null	はい
`complete`	真偽値	はい
`webUrl`	文字列	はい

GET /agent/scans/{scanId}/comparison

スキャンと、それが再チェックする元のスキャンとの違いです。

権限: read
MCPツール: lockpick_compare_scans
x-lockpick-agent-features: finding-code を送ると、各検出結果の code（LP- と 6 文字、Web レポートの表示と同じ）を受け取れます。このヘッダーがない場合、回答に code は含まれず、古いクライアントが想定する形のままです。

data

項目	型	必ず含まれる
`runId`	文字列	はい
`baselineRunId`	文字列	はい
`error`	文字列または null	はい
`changes`	オブジェクトのリスト	はい
`webUrl`	文字列	はい

POST /agent/scans/{scanId}/dns-rechecks

スキャンのDNSを無料で再チェックします。サイトには何も送りません。

権限: pulse
MCPツール: lockpick_recheck_dns

本文

項目	型	必須
`findingId`	文字列	はい
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`findingIds`	文字列のリスト	はい
`pending`	オブジェクトまたは null	はい
`checkedAt`	文字列または null	はい
`outcomes`	オブジェクトのリスト	はい
`nextAllowedAt`	文字列または null	はい
`failedAt`	文字列または null	はい
`originalGradeUnchanged`	真偽値	はい

GET /agent/scans/{scanId}/dns-rechecks/latest

スキャンの最新のDNS再チェックです。

権限: read
MCPツール: lockpick_get_dns_recheck

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`findingIds`	文字列のリスト	はい
`pending`	オブジェクトまたは null	はい
`checkedAt`	文字列または null	はい
`outcomes`	オブジェクトのリスト	はい
`nextAllowedAt`	文字列または null	はい
`failedAt`	文字列または null	はい
`originalGradeUnchanged`	真偽値	はい

POST /agent/scans/{scanId}/deep-rechecks

この修正を確認: Deepの検出事項が見つかった場所だけを読み直します。無料、1日の上限あり。

権限: deep
MCPツール: lockpick_recheck_finding

本文

項目	型	必須
`findingId`	文字列	はい
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`findingId`	文字列	はい
`pending`	オブジェクトまたは null	はい
`latest`	オブジェクトまたは null	はい
`failedAt`	文字列または null	はい
`remainingToday`	整数	はい
`workspaceRemainingToday`	整数	はい
`webUrl`	文字列	はい
`originalGradeUnchanged`	真偽値	はい

GET /agent/scans/{scanId}/deep-rechecks/{findingId}

Deepの検出事項1件の最新の「この修正を確認」。

権限: read
MCPツール: lockpick_get_finding_recheck

data

項目	型	必ず含まれる
`scanId`	文字列	はい
`findingId`	文字列	はい
`pending`	オブジェクトまたは null	はい
`latest`	オブジェクトまたは null	はい
`failedAt`	文字列または null	はい
`remainingToday`	整数	はい
`workspaceRemainingToday`	整数	はい
`webUrl`	文字列	はい
`originalGradeUnchanged`	真偽値	はい

POST /agent/quick-checks

ホームページのクイックチェックを無料で開始します。

権限: pulse
MCPツール: lockpick_quick_check

本文

項目	型	必須
`url`	文字列	はい
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`checkId`	文字列	はい
`status`	`queued`、`running`、`succeeded`、`failed`	はい
`reused`	真偽値	はい
`headline`	オブジェクト	はい
`summary`	文字列または null	はい
`checks`	オブジェクトのリスト	はい
`webUrl`	文字列	はい
`suggestedPollAfterSeconds`	整数または null	はい

POST /agent/repository-checks

インストール前に、公開 GitHub リポジトリ（スキル、プラグイン、MCP サーバー、アプリ）をチェックします。

権限: pulse
MCPツール: lockpick_check_repository

本文

項目	型	必須
`url`	文字列	はい
`mode`	`skill`、`app`	いいえ
`depth`	`free`, `deep`	いいえ
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`checkId`	文字列	はい
`status`	`queued`、`running`、`succeeded`、`failed`	はい
`reused`	真偽値	はい
`repository`	オブジェクト	はい
`mode`	`skill`、`app`、または null	はい
`kind`	文字列、または null	はい
`verdict`	`safe`、`caution`、`do_not_install`、または null	はい
`appRisk`	`low`、`elevated`、`high`、または null	はい
`score`	整数、または null	はい
`summary`	文字列または null	はい
`plainSummary`	文字列、または null	はい
`findings`	オブジェクトのリスト	はい
`moreFindings`	整数	はい
`coverage`	オブジェクト、または null	はい
`failure`	`not-found`、`ref-not-found`、`empty`、`too-large`、`rate-limited`、`unavailable`、`timeout`、`engine-error`、または null	はい
`webUrl`	文字列	はい
`suggestedPollAfterSeconds`	整数または null	はい

GET /agent/repository-checks/{checkId}

リポジトリチェックとその指摘です。

権限: read
MCPツール: lockpick_get_repository_check

data

項目	型	必ず含まれる
`checkId`	文字列	はい
`status`	`queued`、`running`、`succeeded`、`failed`	はい
`reused`	真偽値	はい
`repository`	オブジェクト	はい
`mode`	`skill`、`app`、または null	はい
`kind`	文字列、または null	はい
`verdict`	`safe`、`caution`、`do_not_install`、または null	はい
`appRisk`	`low`、`elevated`、`high`、または null	はい
`score`	整数、または null	はい
`summary`	文字列または null	はい
`plainSummary`	文字列、または null	はい
`findings`	オブジェクトのリスト	はい
`moreFindings`	整数	はい
`coverage`	オブジェクト、または null	はい
`failure`	`not-found`、`ref-not-found`、`empty`、`too-large`、`rate-limited`、`unavailable`、`timeout`、`engine-error`、または null	はい
`webUrl`	文字列	はい
`suggestedPollAfterSeconds`	整数または null	はい

GET /agent/quick-checks/{checkId}

クイックチェックとその結果です。

権限: read
MCPツール: lockpick_get_quick_check

data

項目	型	必ず含まれる
`checkId`	文字列	はい
`status`	`queued`、`running`、`succeeded`、`failed`	はい
`reused`	真偽値	はい
`headline`	オブジェクト	はい
`summary`	文字列または null	はい
`checks`	オブジェクトのリスト	はい
`webUrl`	文字列	はい
`suggestedPollAfterSeconds`	整数または null	はい

GET /agent/docs/search

Lockpickの公開ドキュメントを検索します。

権限: read
MCPツール: lockpick_search_docs

クエリ

項目	型	必須
`query`	文字列	はい
`limit`	整数	いいえ

data

項目	型	必ず含まれる
`query`	文字列	はい
`results`	オブジェクトのリスト	はい

GET /agent/docs/page

公開ドキュメントの1ページをMarkdownで返します。長い場合は分けて返します。

権限: read
MCPツール: lockpick_read_doc

クエリ

項目	型	必須
`path`	文字列	いいえ
`cursor`	文字列	いいえ

data

項目	型	必ず含まれる
`path`	文字列	はい
`title`	文字列	はい
`description`	文字列または null	はい
`url`	文字列	はい
`markdownUrl`	文字列	はい
`markdown`	文字列	はい
`nextCursor`	文字列または null	はい
`complete`	真偽値	はい

lockpick login がキーを取得する仕組みです。コードを取得し、本人がブラウザーで承認すると、ポーリングでキーが返ります。

POST /device/code

デバイスでのサインインを開始し、本人がブラウザーで承認するためのコードを取得します。

権限: なし（サインインの一部）

本文

項目	型	必須
`clientName`	文字列	いいえ
`hostname`	文字列	いいえ
`platform`	文字列	いいえ
`version`	文字列	いいえ
`scopes`	`pulse`、`sites`、`deep`, `local` のリスト	いいえ

data

項目	型	必ず含まれる
`deviceCode`	文字列	はい
`userCode`	文字列	はい
`verificationUri`	文字列	はい
`verificationUriComplete`	文字列	はい
`expiresIn`	整数	はい
`interval`	整数	はい

POST /device/token

本人が承認するまでデバイスでのサインインをポーリングし、承認されたらキーを受け取ります。

権限: なし（サインインの一部）

本文

項目	型	必須
`deviceCode`	文字列	はい

旧API

CLI 0.2 が使っている元のCLIのルートです。そのまま残しています。新しい連携では、上のエージェントAPIを使ってください。

元のCLIのルート

GET /projects/{projectId}/dismissals

このプロジェクトの受け入れた検出結果と理由を管理します。取り消すと再び有効になります。証拠や検査ルールが変わった場合は再確認が必要です。ローカル監査ではコードとレポートは自分のマシンに残ります。オンライン認可は引き続き必要です。

権限: read

data

項目	型	必ず含まれる
`version`	数値	はい
`projectId`	文字列	はい
`dismissals`	オブジェクトのリスト	はい

POST /projects/{projectId}/dismissals

権限: sites

本文

項目	型	必須
`version`	数値	はい
`projectId`	文字列	はい
`dismissals`	オブジェクトのリスト	はい

data

項目	型	必ず含まれる
`imported`	整数	はい

POST /projects/{projectId}/local-assessments/authorize

リポジトリを検査する前にローカル評価を承認します。ソースや結果はアップロードされません。

権限: local

本文

項目	型	必須
`cliVersion`	文字列	はい
`scannerVersion`	文字列	はい
`rulesetVersion`	文字列	はい
`reportSchemaVersion`	文字列	はい
`checks`	list of `tracked-secrets`, `public-environment`, `browser-artifacts`, `supabase-client`, `supabase-migrations`, `git-history`, `docker-files`, `docker-values`, `actions-injection`, `source-maps`, `php-version`, `actions-policy`, `compose-policy`, `hosting-config`	はい

data

項目	型	必ず含まれる
`admissionId`	文字列	はい
`projectId`	文字列	はい
`workspaceId`	文字列	はい
`policyVersion`	文字列	はい
`startBy`	文字列	はい
`checks`	オブジェクトのリスト	はい

GET /me

このキーの背後にあるユーザー、ワークスペース、キーです。

権限: read

data

項目	型	必ず含まれる
`user`	オブジェクト	はい
`workspace`	オブジェクト	はい
`key`	オブジェクト	はい

DELETE /me

提示されたキーを取り消します。

権限: 有効なキーであれば何でもよい

data

項目	型	必ず含まれる
`revoked`	真偽値	はい

GET /projects

サイト（プロジェクト）と、それぞれの最新のPulseとDeepスキャンです。

権限: read

data内の各項目

項目	型	必ず含まれる
`id`	文字列	はい
`name`	文字列	はい
`status`	文字列	はい
`baseDomain`	文字列または null	はい
`latestPulse`	オブジェクトまたは null	はい
`latestDeep`	オブジェクトまたは null	いいえ
`latestBox`	オブジェクトまたは null	はい
`webPath`	文字列	はい
`webUrl`	文字列	いいえ

GET /projects/{projectId}/status

1つのサイトの最新の結果と、変更された内容です。

権限: read

data

項目	型	必ず含まれる
`project`	オブジェクト	はい
`latestPulse`	オブジェクトまたは null	はい
`latestDeep`	オブジェクトまたは null	いいえ
`latestBox`	オブジェクトまたは null	はい
`lastComparison`	オブジェクトまたは null	はい
`fixes`	オブジェクトまたは null	いいえ
`caveats`	文字列のリスト	はい

POST /projects/{projectId}/pulse

サイトでPulseを開始します。または、最新のPulseを再チェックします。

権限: pulse
成功時は 201 を返します

本文

項目	型	必須
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`id`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`projectId`	文字列	はい
`target`	文字列	はい
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	はい
`mode`	`autonomous`、`authenticated`、`active`、または null	はい
`createdAt`	文字列または null	はい
`finishedAt`	文字列または null	はい
`webPath`	文字列	はい
`assessmentLevel`	`pulse`、`standard`、`deep`、または null	いいえ
`headline`	オブジェクト	いいえ
`webUrl`	文字列	いいえ
`suggestedPollAfterSeconds`	整数または null	いいえ
`dismissals`	オブジェクト	いいえ
`baselineRunId`	文字列または null	はい
`open`	オブジェクト	はい
`findingCount`	整数	はい
`progress`	オブジェクトまたは null	はい
`coverage`	オブジェクト	はい
`caveats`	文字列のリスト	はい
`outcome`	オブジェクトまたは null	いいえ
`exposureCheck`	オブジェクトまたは null	いいえ
`coverageReceipt`	オブジェクトまたは null	いいえ

POST /projects/{projectId}/deep

このサイト向けにDeepを許可したCIキーを使って、リリースのDeepスキャンを開始します。

権限: deep
成功時は 201 を返します

本文

項目	型	必須
`idempotencyKey`	文字列	はい

data

項目	型	必ず含まれる
`id`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`projectId`	文字列	はい
`target`	文字列	はい
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	はい
`mode`	`autonomous`、`authenticated`、`active`、または null	はい
`createdAt`	文字列または null	はい
`finishedAt`	文字列または null	はい
`webPath`	文字列	はい
`assessmentLevel`	`pulse`、`standard`、`deep`、または null	いいえ
`headline`	オブジェクト	いいえ
`webUrl`	文字列	いいえ
`suggestedPollAfterSeconds`	整数または null	いいえ
`dismissals`	オブジェクト	いいえ
`baselineRunId`	文字列または null	はい
`open`	オブジェクト	はい
`findingCount`	整数	はい
`progress`	オブジェクトまたは null	はい
`coverage`	オブジェクト	はい
`caveats`	文字列のリスト	はい
`outcome`	オブジェクトまたは null	いいえ
`exposureCheck`	オブジェクトまたは null	いいえ
`coverageReceipt`	オブジェクトまたは null	いいえ

GET /runs

PulseとDeepのスキャンを、新しい順に返します。

権限: read

クエリ

項目	型	必須
`projectId`	文字列	いいえ
`kind`	`pulse`、`box`（Deep、旧名称）	いいえ
`assessmentLevel`	`pulse`、`standard`、`deep`	いいえ
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	いいえ
`limit`	整数	いいえ

data内の各項目

項目	型	必ず含まれる
`id`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`projectId`	文字列	はい
`target`	文字列	はい
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	はい
`mode`	`autonomous`、`authenticated`、`active`、または null	はい
`createdAt`	文字列または null	はい
`finishedAt`	文字列または null	はい
`webPath`	文字列	はい
`assessmentLevel`	`pulse`、`standard`、`deep`、または null	いいえ
`headline`	オブジェクト	いいえ
`webUrl`	文字列	いいえ
`suggestedPollAfterSeconds`	整数または null	いいえ

GET /runs/{runId}

1つのランを、見出しと件数とともに返します。

権限: read

data

項目	型	必ず含まれる
`id`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`projectId`	文字列	はい
`target`	文字列	はい
`status`	`queued`、`running`、`cancelling`、`succeeded`、`incomplete`、`failed`、`cancelled`	はい
`mode`	`autonomous`、`authenticated`、`active`、または null	はい
`createdAt`	文字列または null	はい
`finishedAt`	文字列または null	はい
`webPath`	文字列	はい
`assessmentLevel`	`pulse`、`standard`、`deep`、または null	いいえ
`headline`	オブジェクト	いいえ
`webUrl`	文字列	いいえ
`suggestedPollAfterSeconds`	整数または null	いいえ
`dismissals`	オブジェクト	いいえ
`baselineRunId`	文字列または null	はい
`open`	オブジェクト	はい
`findingCount`	整数	はい
`progress`	オブジェクトまたは null	はい
`coverage`	オブジェクト	はい
`caveats`	文字列のリスト	はい
`outcome`	オブジェクトまたは null	いいえ
`exposureCheck`	オブジェクトまたは null	いいえ
`coverageReceipt`	オブジェクトまたは null	いいえ

GET /runs/{runId}/findings

ランの検出事項です。

権限: read

クエリ

項目	型	必須
`severity`	`critical`、`high`、`medium`、`low`、`info`	いいえ
`state`	`attention`、`information`、`unknown`、`pass`	いいえ
`all`	`true`、`false`	いいえ

data内の各項目

項目	型	必ず含まれる
`dismissal`	オブジェクト	いいえ
`id`	文字列	はい
`code`	文字列	いいえ
`runId`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`severity`	`critical`、`high`、`medium`、`low`、`info`	はい
`state`	`attention`、`information`、`unknown`、`pass`	はい
`category`	文字列	はい
`title`	文字列	はい
`meaning`	文字列	はい
`fix`	文字列または null	はい
`confidence`	文字列	はい
`evidence`	文字列のリスト	はい
`sources`	文字列のリスト	はい
`steps`	文字列のリスト	はい
`webPath`	文字列	はい
`webUrl`	文字列	いいえ
`verdict`	`confirmed`、`needs_review`、`not_actionable`、または null	いいえ
`certainty`	`high`、`medium`、`low`、または null	いいえ
`exploitability`	`direct`、`conditional`、`hygiene`、`none`、または null	いいえ
`proof`	オブジェクトまたは null	いいえ
`proofGap`	文字列または null	いいえ
`urgency`	`now`、`week`、`later`、`none`	いいえ
`howSure`	`confirmed`、`likely`、`possible`、または null	いいえ
`lifecycle`	オブジェクトまたは null	いいえ

GET /runs/{runId}/findings/{findingId}

1つの検出事項を、秘匿された証拠とともに返します。

権限: read

data

項目	型	必ず含まれる
`dismissal`	オブジェクト	いいえ
`id`	文字列	はい
`code`	文字列	いいえ
`runId`	文字列	はい
`kind`	`pulse`、`box`（Deep、旧名称）	はい
`severity`	`critical`、`high`、`medium`、`low`、`info`	はい
`state`	`attention`、`information`、`unknown`、`pass`	はい
`category`	文字列	はい
`title`	文字列	はい
`meaning`	文字列	はい
`fix`	文字列または null	はい
`confidence`	文字列	はい
`evidence`	文字列のリスト	はい
`sources`	文字列のリスト	はい
`steps`	文字列のリスト	はい
`webPath`	文字列	はい
`webUrl`	文字列	いいえ
`verdict`	`confirmed`、`needs_review`、`not_actionable`、または null	いいえ
`certainty`	`high`、`medium`、`low`、または null	いいえ
`exploitability`	`direct`、`conditional`、`hygiene`、`none`、または null	いいえ
`proof`	オブジェクトまたは null	いいえ
`proofGap`	文字列または null	いいえ
`urgency`	`now`、`week`、`later`、`none`	いいえ
`howSure`	`confirmed`、`likely`、`possible`、または null	いいえ
`lifecycle`	オブジェクトまたは null	いいえ

GET /runs/{runId}/repair-brief

ランの修正内容を、1つのMarkdownブリーフとして返します。

権限: read

クエリ

項目	型	必須
`findingId`	文字列	いいえ
`agent`	`claude-code`、`codex`、`cursor`、`vscode`、`opencode`、`lovable`、`bolt`、`replit`、`v0`	いいえ

data

項目	型	必ず含まれる
`runId`	文字列	はい
`findingIds`	文字列のリスト	はい
`saved`	真偽値	はい
`markdown`	文字列	はい
`webUrl`	文字列	いいえ

GET /runs/{runId}/comparison

ランと、その1つ前のランとの違いです。

権限: read

data

項目	型	必ず含まれる
`runId`	文字列	はい
`baselineRunId`	文字列	はい
`error`	文字列または null	はい
`changes`	オブジェクトのリスト	はい
`webUrl`	文字列	いいえ

GET /runs/{runId}/export

スキャンの結果をPDFにしたものです。わかりやすい言葉または技術的な内容で、base64でエンコードされています。

権限: read

クエリ

項目	型	必須
`dialect`	`plain`, `technical`	はい

data

項目	型	必ず含まれる
`filename`	文字列	はい
`mimeType`	文字列	はい
`base64`	文字列	はい

このページは役に立ちましたか？

リファレンス

任意の分析