API リファレンス

ブラウザのエンドポイント

実行、ボールトシークレット、ファイル、プロファイルを扱う /v1/browser のすべてのエンドポイントについて、パラメータ、制限、レスポンス、エラーを説明します。

ブラウザエージェント API は https://lovelyrouter.com/v1/browser 以下にあります。すべてのリクエストは、API キーを Authorization: Bearer $LOVELY_API_KEY として送って認証します（認証）。リクエストとレスポンスのボディは、ファイルのアップロードとスクリーンショットを除いて JSON です。実行はプリペイド残高から課金されます。詳しくはモード、モデル、料金を参照してください。

使い方の流れを知るには、まずブラウザエージェントの概要をお読みください。

実行オブジェクト#

実行とは、エージェントに任せる 1 つのタスクです。実行のエンドポイントはすべてこのオブジェクトを返します。API のみ と記したフィールドは、Webhook のペイロードには含まれません。

属性

idstring

一意の ID。brun_ に続く 24 文字です。

objectstring

常に browser_run。

statusstring

running、waiting_for_human、succeeded、failed、timed_out、stopped のいずれか。

goalstring

送信した目標。

start_urlstring

実行を開始した URL。

enginestring

常に chromium。

modestring

fast または accurate。

modelstring | null

model で選んだモデル。標準で含まれるモデルを使う場合は null。

model_usdnumber

model を選んだ場合のみ。そのモデルのトークンにこれまでにかかった費用で、20% の追加料金を含みます。

stepsinteger

これまでに記録されたステップ数。人の対応を待つ一時停止も含みます。一時停止は課金されません。

max_stepsinteger

実行のステップ上限。

billable_time_sinteger

これまでの課金対象の秒数。各ステップと各一時停止に含まれる 1 分を超えた分です。

time_usdnumber

billable_time_s の費用。1 分あたり $0.005 です。

current_urlstring

ブラウザが現在表示しているページ、または実行終了時に表示していたページ。

answerstring | null

終了後のエージェントの回答。max_steps に達した実行でも、最後のページから回答が作られます。

dataobject | array | null

実行終了後の構造化出力。output_schema を渡した場合、または目標で構造を指定した場合に含まれます。構造化出力を参照してください。

data_errorstring

構造化出力に失敗した場合にのみ含まれ、その理由を示します。

errorstring | null

実行が成功しなかった理由（例：reached the step limit (50)、blocked by the website、no human response within 30 minutes、stopped by the user）。

needsobject | null

status が waiting_for_human のとき、実行が何を待っているか。それ以外は null。

profile_savedobject | null

save_profile を指定した場合に、実行終了時に保存されたプロファイル。id、name、cookies（保存した Cookie の数）を含みます。

usageobject

decision_calls と llm_calls。エージェントが行ったモデル呼び出しの回数です。参考情報で、料金はステップ単価に含まれます。

created_atstring

実行の開始日時（ISO 8601）。

finished_atstring | null

実行の終了日時。

tracearray

?trace=1 を指定した場合のみ。ステップごとに 1 要素で、step、url、action（click:e12、type:e3、choose:e5、secret:e4:shop_password、upload:e9、back、done など。一時停止の場合は ask、approval、handoff）、description、ms（所要時間）、error（null、またはステップが失敗した理由）を含みます。

charge_usdnumber | null

API のみ。 実行にかかった費用。実行終了から数秒後に精算されると値が入り、それまでは null です。

reserved_usdnumber

API のみ。 実行中に仮押さえされている金額。精算後は 0 です。

The run object

{
  "id": "brun_3f9a1c7e0b2d4e6f8a9b0c1d",
  "object": "browser_run",
  "status": "succeeded",
  "goal": "Find the price of the book \"A Light in the Attic\" and whether it is in stock.",
  "start_url": "https://books.toscrape.com/",
  "engine": "chromium",
  "mode": "fast",
  "model": null,
  "steps": 2,
  "max_steps": 50,
  "billable_time_s": 0,
  "time_usd": 0,
  "current_url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
  "answer": "\"A Light in the Attic\" costs £51.77 and is in stock (22 available).",
  "data": null,
  "error": null,
  "needs": null,
  "profile_saved": null,
  "usage": { "decision_calls": 3, "llm_calls": 1 },
  "created_at": "2026-10-11T09:30:00.000Z",
  "finished_at": "2026-10-11T09:30:07.000Z",
  "trace": [
    {
      "step": 1,
      "url": "https://books.toscrape.com/",
      "action": "click:e54",
      "description": "click link \"A Light in the ...\" → https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
      "ms": 2140,
      "error": null
    },
    {
      "step": 2,
      "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
      "action": "done",
      "description": "Read the result and wrote the answer",
      "ms": 2875,
      "error": null
    }
  ],
  "charge_usd": 0.012,
  "reserved_usd": 0
}

実行を作成する#

POST/v1/browser/runs

実行を開始し、すぐに 202 と実行オブジェクトを返します。エージェントはバックグラウンドで動作します。進行状況はイベントストリーム、実行を取得する、または Webhook で追跡してください。実行を開始すると、最大費用が残高から仮押さえされます（仮押さえの仕組み）。

レスポンスには、?wait=30 付きのそのまま使えるステータス取得パス poll と、実行のイベントストリーム events も含まれます。webhook を渡した場合は webhook_secret も含まれます。webhook_secret が返されるのはこのレスポンス（ストリーミングで開始した場合は最初のイベント）だけです。

"stream": true を指定すると、レスポンスは代わりに 200 と実行のイベントストリームになり、開始から実行の終了まで続きます。ライブイベントと画面を参照してください。

ボディパラメータ

goalstring必須

何をするかを、タスクに必要な値をすべて含めて平易な言葉で書きます。最大 4,000 文字。うまくいく目標の書き方を参照してください。

start_urlstring必須

最初に開くページ。http または https の URL。

modestringデフォルト fast

fast（1 ステップ $0.006）または accurate（1 ステップ $0.012。迷ったときはスクリーンショットも見て、ページ上で読み取り専用のコードを実行できます）。モードを参照してください。

max_stepsintegerデフォルト 50

ステップ上限。1〜100。範囲外の値は範囲内に収まるよう調整されます。課金されるのは実際に実行したステップ分だけです。

output_schemaobject

data に返す JSON の JSON Schema（draft 2020-12）、または {"title": "string", "items": [{"name": "string"}]} のような省略形。最大 20 KB。

approvestringデフォルト risky

何かを送信する操作（送信ボタン、購入・予約・支払い・送信・削除のボタン、検索以外のフォームでの Enter キー）の前に、一時停止して承認を待つ条件。risky（購入、注文、送信、削除、応募のみ）、submit（そうした操作すべて）、none のいずれか。それ以外の値を指定すると 400 を返します。

humanbooleanデフォルト true

エージェントが質問したり、ブラウザを引き渡したりしてよいかどうか。無人で実行する場合は false にします。

human_timeout_minutesnumberデフォルト 30`（クラウドエージェントが開始した実行は `5`）

一時停止のたびに返信を待つ時間。1〜1,440 分。範囲外の値は範囲内に収まるよう調整されます。この時間が過ぎると、実行は timed_out で終了します。

secretsarray

エージェントが入力できるボールトシークレットの名前。

ephemeral_secretsobject

この実行専用のシークレット。実行終了時に削除されます。名前（ボールトの名前と同じ規則）をキーとし、次の値を持つマップです。

filesarray | string

エージェントが添付できるアップロード済みファイルの名前または ID。すべてを許可する場合は "*"。

profilestring

開始時に使う保存済みプロファイルの名前または ID。

save_profilestring

実行終了時に、セッションの Cookie とローカルストレージをこの名前で保存します。最大 64 文字。

allowed_domainsarray

ブラウザがアクセスできるホスト名（例："example.com"、"*.example.com"）。最大 50 個。

webhookstring

run.waiting と run.finished のイベントを受け取る https の URL。

modelstring

エージェントの思考、入力文の作成、データ抽出に使うモデルの ID。GET /v1/models から選びます（例：claude-sonnet-5.5）。トークンは通常価格に 20% を上乗せして課金されます。

max_model_usdnumber

model を指定した場合に、そのトークンにかけてよい費用の上限（追加料金を含む）。デフォルトは max_steps とモデルの価格から見積もった値です。

streambooleanデフォルト false

true にすると、202 の JSON の代わりに実行のイベントストリーム（text/event-stream）を返します。

screenbooleanデフォルト false

stream と併用：ブラウザ画面を含む frame イベントを追加します。

Shell

curl https://lovelyrouter.com/v1/browser/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "goal": "Find the price of the book \"A Light in the Attic\" and whether it is in stock.",
    "start_url": "https://books.toscrape.com/"
  }'

Response

{
  "id": "brun_3f9a1c7e0b2d4e6f8a9b0c1d",
  "object": "browser_run",
  "status": "running",
  "goal": "Find the price of the book \"A Light in the Attic\" and whether it is in stock.",
  "start_url": "https://books.toscrape.com/",
  "engine": "chromium",
  "mode": "fast",
  "model": null,
  "steps": 0,
  "max_steps": 50,
  "billable_time_s": 0,
  "time_usd": 0,
  "current_url": "https://books.toscrape.com/",
  "answer": null,
  "data": null,
  "error": null,
  "needs": null,
  "profile_saved": null,
  "usage": { "decision_calls": 0, "llm_calls": 0 },
  "created_at": "2026-10-11T09:30:00.000Z",
  "finished_at": null,
  "poll": "/v1/browser/runs/brun_3f9a1c7e0b2d4e6f8a9b0c1d?wait=30",
  "events": "/v1/browser/runs/brun_3f9a1c7e0b2d4e6f8a9b0c1d/events",
  "charge_usd": null,
  "reserved_usd": 0.445
}

実行を取得する#

GET/v1/browser/runs/{id}

実行オブジェクトを返します。wait を指定すると、実行のステータス（または一時停止の種類）が変わるか、wait 秒が経過するまでリクエストを保留し、その時点の状態を返します。実行が waiting_for_human の間は、すぐに返します。

クエリパラメータ

waitintegerデフォルト 0

実行が running の間、リクエストを保留する秒数。最大 50。

tracestring

1 を指定すると、これまでのステップの一覧である trace が追加されます。

Shell

curl "https://lovelyrouter.com/v1/browser/runs/brun_3f9a1c7e0b2d4e6f8a9b0c1d?wait=30&trace=1" \
  -H "Authorization: Bearer $LOVELY_API_KEY"

レスポンスは実行オブジェクトです。trace=1 を渡した場合は trace も含まれます。

実行をストリーミングする#

GET/v1/browser/runs/{id}/events

実行のライブイベントを、実行が終わるまで Server-Sent Events（text/event-stream）で返します。最初のイベントは trace 付きの実行オブジェクトです。その後に activity（エージェントがいま行っていること）、step（完了した各ステップ）、run（各ステップの後と、一時停止の開始・終了時）、screen を指定した場合は frame（ブラウザ画面）が続きます。最後のイベントは charge_usd 付きの終了した実行と end です。終了済みの実行では、run イベントと end がすぐに送られます。: で始まる行はキープアライブのコメントです。ライブイベントと画面を参照してください。

Query parameters

screenstring

1 で frame イベントを追加します：data（ブラウザの base64 JPEG）と at。接続時に 1 枚、その後はページが変わるたびに、最大で毎秒約 4 枚送られます。

イベント	`data`
`run`	`charge_usd` と `reserved_usd` 付きの実行オブジェクト。最初のものには `trace` が含まれます
`activity`	`step`、`kind`（`starting`、`reading`、`waiting`、`deciding`、`thinking`、`checking`、`acting`、`answering`、`extracting`）、`text`
`step`	`trace` の 1 件
`frame`	`data`（base64 JPEG）と `at`
`end`	`id`

cURL

curl -N "https://lovelyrouter.com/v1/browser/runs/brun_3f9a1c7e0b2d4e6f8a9b0c1d/events?screen=1" \
  -H "Authorization: Bearer $LOVELY_API_KEY"

レスポンス

event: run
data: {"id":"brun_3f9a1c7e0b2d4e6f8a9b0c1d","object":"browser_run","status":"running","steps":1,"trace":[…],…}

event: frame
data: {"data":"/9j/4AAQSkZJRgABAQ…","at":"2026-10-11T09:30:03.120Z"}

event: activity
data: {"step":2,"kind":"answering","text":"Reading the result and writing the answer"}

event: step
data: {"step":2,"url":"https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html","action":"done","description":"Read the result and wrote the answer","ms":2875,"error":null}

event: run
data: {"id":"brun_3f9a1c7e0b2d4e6f8a9b0c1d","status":"succeeded","answer":"\"A Light in the Attic\" costs £51.77 and is in stock (22 available).","charge_usd":0.012,…}

event: end
data: {"id":"brun_3f9a1c7e0b2d4e6f8a9b0c1d"}

実行を一覧表示する#

GET/v1/browser/runs

直近 50 件のブラウザエージェントの実行を、新しい順に簡略形式で返します。完全な状態を知るには、実行を個別に取得してください。

フィールド	意味
`id`	実行 ID
`billing_status`	精算されるまでは `running`。精算後は `succeeded`、`failed`、`timed_out`、`stopped` のいずれか
`goal`	目標の先頭 200 文字
`steps`	課金されたステップ数。精算されるまでは `0`
`created_at`	実行の開始日時

cURL

curl https://lovelyrouter.com/v1/browser/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "brun_3f9a1c7e0b2d4e6f8a9b0c1d",
      "billing_status": "succeeded",
      "goal": "Find the price of the book \"A Light in the Attic\" and whether it is in stock.",
      "steps": 2,
      "created_at": "2026-10-11T09:30:00.000Z"
    }
  ]
}

実行に返信する#

POST/v1/browser/runs/{id}/reply

waiting_for_human の実行に返信します。needs.kind に合った返信を 1 種類だけ送ってください。status が running に戻った実行オブジェクトを 200 で返します。人による確認を参照してください。

ボディパラメータ

answerstring

question への返信。エージェントが読むテキストです。最大 2,000 文字。

secretstring

question への返信。エージェントが値を見ないまま、現在のサイトで入力する値です。最大 4,096 文字。そのサイトのテキスト系の入力欄であれば、パスワード欄や PIN 欄も含めてどこにでも入力できます。

approveboolean

approval への返信。true でエージェントにボタンのクリックを許可し、false で拒否します。

denyboolean

approval への返信。true は "approve": false と同じです。

reasonstring

拒否する場合に、その理由をエージェントに伝えます。最大 500 文字。

doneboolean

takeover への返信。人の操作が終わったら true にします。エージェントは現在のページから続行します。

failedboolean

takeover への返信。人が操作を完了できなかった場合は true にします。

notestring

done または failed と一緒に、人が行ったことをエージェントに伝えます。最大 500 文字。

エラー：ボディがどの返信の形式にも当てはまらない場合は 400、実行が返信を待っていない場合は 409 This run is not waiting for a reply、返信が一時停止の種類と合わない場合は 409 This run is waiting for a reply of kind "question"（または approval、takeover）を返します。

cURL

curl https://lovelyrouter.com/v1/browser/runs/brun_5b7d9f1a3c5e7a9b1d3f5a7c/reply \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"secret": "481923"}'

Reply bodies

{"answer": "Use the billing address."}
{"approve": true}
{"approve": false, "reason": "Wrong delivery date"}
{"done": true, "note": "Solved the CAPTCHA"}
{"failed": true, "note": "The site asked for a phone call"}

実行を引き継ぐ#

POST/v1/browser/runs/{id}/takeover

進行中のステップが終わった後に、ブラウザを引き渡すよう実行に求めます。202 と実行オブジェクトを返します。次に取得するステータスは waiting_for_human になり、needs.kind は takeover で、live_view_url が含まれます。操作を戻すには、{"done": true} で返信します。

実行が質問または承認を待っている場合、引き継ぎはそれに返信した後に始まります。終了した実行では、This run has finished とともに 409 を返します。

ボディパラメータ

instructionsstring

一時停止の prompt として表示されます。最大 500 文字。デフォルト：The user asked to take over the browser.

cURL

curl https://lovelyrouter.com/v1/browser/runs/brun_5b7d9f1a3c5e7a9b1d3f5a7c/takeover \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"instructions": "I will pick the delivery slot myself."}'

実行を停止する#

POST/v1/browser/runs/{id}/stop

実行を停止します。実行は次のステップの区切りで stopped として終了します。人の対応を待っている場合はすぐに終了します。停止前の状態の実行オブジェクトを 202 で返し、次に取得するステータスは stopped になります。停止した実行では、実行したステップ分の料金がかかり、data は返されません。

cURL

curl -X POST https://lovelyrouter.com/v1/browser/runs/brun_3f9a1c7e0b2d4e6f8a9b0c1d/stop \
  -H "Authorization: Bearer $LOVELY_API_KEY"

スクリーンショットを取得する#

GET/v1/browser/runs/{id}/screenshot

ブラウザの JPEG（image/jpeg）を返します。実行のブラウザが開いている間は現在の画面を、それ以外は保存されている最新のもの（人の対応待ちが始まった時点のページ、または終了した実行の最後のページ）を返します。このパスは needs.screenshot に入っています。スクリーンショットがない場合は、No screenshot yet とともに 404 を返します。画面を継続して見るには、screen=1 で実行をストリーミングしてください。

cURL

curl https://lovelyrouter.com/v1/browser/runs/brun_5b7d9f1a3c5e7a9b1d3f5a7c/screenshot \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -o screen.jpg

シークレットを保存する#

PUT/v1/browser/vault/{name}

書き込み専用のシークレットを保存します。同じ名前のシークレットがあれば置き換えます。エージェントは指定されたオリジンでのみこれを入力でき、モデルが値を見ることはありません。ログイン、シークレット、プロファイルを参照してください。

パスパラメータ

namestring必須

1〜64 文字。小文字の a-z、0-9、_、.、- が使え、先頭は英字か数字にします。

ボディパラメータ

valuestring必須

シークレットの値。最大 4 KB（超えると 413）。totp の場合は base32 のシード（A-Z、2-7 で 16 文字以上）。

kindstringデフォルト password

password（パスワード欄のみ）、username または text（テキスト系の入力欄。パスワード欄は不可）、totp（現在の 6 桁のコードとして入力）のいずれか。

originsarray必須

オリジン 1〜20 個（例：https://github.com、https://*.example.com）。https のみ使えます。ただし http://localhost と http://127.0.0.1 は例外です。

cURL

curl -X PUT https://lovelyrouter.com/v1/browser/vault/github_password \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"value": "correct-horse-battery-staple", "kind": "password", "origins": ["https://github.com"]}'

Response

{ "name": "github_password", "kind": "password", "origins": ["https://github.com"], "stored": true }

シークレットを一覧表示する#

GET/v1/browser/vault

シークレットを名前で一覧表示します。値は含まれません。

cURL

curl https://lovelyrouter.com/v1/browser/vault \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "name": "github_password",
      "kind": "password",
      "origins": ["https://github.com"],
      "created_at": "2026-10-11T09:00:00.000Z",
      "updated_at": "2026-10-11T09:00:00.000Z",
      "last_used_at": "2026-10-11T09:12:31.000Z"
    }
  ]
}

シークレットを削除する#

DELETE/v1/browser/vault/{name}

シークレットを削除します。このシークレットを指定している実行は、以後これを入力できなくなります。該当するシークレットがない場合は、No such secret とともに 404 を返します。

cURL

curl -X DELETE https://lovelyrouter.com/v1/browser/vault/github_password \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{ "deleted": "github_password" }

ファイルをアップロードする#

PUT/v1/browser/files/{name}

エージェントがフォームに添付できるファイルをアップロードします。同じ名前のファイルがあれば置き換えます（id は維持されます）。ファイルの生のバイト列をボディとして、ファイルの種類を Content-Type として送ります。ファイルアップロードを参照してください。

パスパラメータとクエリパラメータ

namestring必須

URL エンコードしてパスに指定します。1〜128 文字。英字、数字、スペース、. _ - ( ) + , が使え、先頭は英字、数字、_ のいずれかにします。

descriptionstring

クエリパラメータ。ファイルの説明で、エージェントがファイルを選ぶ手がかりになります。最大 300 文字。

ファイルは 1 つあたり 10 MB まで（超えると 413）、アカウントあたり 100 個まで（超えると 409 file limit reached (100); delete some first）です。

cURL

curl -X PUT "https://lovelyrouter.com/v1/browser/files/Maria_Garcia_CV_2026.pdf?description=Resume" \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/pdf" \
  --data-binary @Maria_Garcia_CV_2026.pdf

Response

{
  "id": "file_7a3c9e1b5d2f8a4c6e0b",
  "name": "Maria_Garcia_CV_2026.pdf",
  "mime": "application/pdf",
  "bytes": 84213,
  "sha256": "5f2b8c…",
  "description": "Resume",
  "created_at": "2026-10-11T09:20:44.000Z",
  "last_used_at": null
}

フォームでファイルをアップロードする#

POST/v1/browser/files

ファイルをアップロードすると同じ処理を、multipart/form-data で行います。同じファイルオブジェクトを返します。

フォームフィールド

filefile必須

ファイル本体。種類はパートのコンテンツタイプから判断されます。

namestring

保存時の名前。デフォルトはアップロードしたファイルの名前です。

descriptionstring

ファイルの説明。最大 300 文字。

cURL

curl https://lovelyrouter.com/v1/browser/files \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F "file=@Maria_Garcia_CV_2026.pdf;type=application/pdf" \
  -F "description=Resume"

ファイルを一覧表示する#

GET/v1/browser/files

アップロードしたファイルを名前順に一覧表示します。last_used_at は、実行が最後にそのファイルを添付した日時です。

cURL

curl https://lovelyrouter.com/v1/browser/files \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "file_7a3c9e1b5d2f8a4c6e0b",
      "name": "Maria_Garcia_CV_2026.pdf",
      "mime": "application/pdf",
      "bytes": 84213,
      "sha256": "5f2b8c…",
      "description": "Resume",
      "created_at": "2026-10-11T09:20:44.000Z",
      "last_used_at": "2026-10-11T09:47:10.000Z"
    }
  ]
}

ファイルを削除する#

DELETE/v1/browser/files/{name}

名前または ID を指定してファイルを削除します。該当するファイルがない場合は、No such file とともに 404 を返します。

cURL

curl -X DELETE https://lovelyrouter.com/v1/browser/files/Maria_Garcia_CV_2026.pdf \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{ "deleted": "Maria_Garcia_CV_2026.pdf" }

プロファイルを一覧表示する#

GET/v1/browser/profiles

保存済みのセッションを、更新日時の新しい順に一覧表示します。実行は save_profile でプロファイルを作成・更新し、profile でプロファイルから開始します。origins はプロファイルが Cookie やローカルストレージを保持しているサイト、bytes はプロファイルのサイズです。

cURL

curl https://lovelyrouter.com/v1/browser/profiles \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "prof_4c1e9a7b2d0f3e5a8b6c",
      "name": "shop-login",
      "origins": ["https://shop.example.com"],
      "bytes": 18342,
      "created_at": "2026-10-10T16:02:11.000Z",
      "updated_at": "2026-10-11T09:15:40.000Z",
      "last_used_at": "2026-10-11T09:14:58.000Z"
    }
  ]
}

プロファイルを削除する#

DELETE/v1/browser/profiles/{id}

ID または名前を指定してプロファイルを削除します。該当するプロファイルがない場合は、No such profile とともに 404 を返します。

cURL

curl -X DELETE https://lovelyrouter.com/v1/browser/profiles/shop-login \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Response

{ "deleted": "shop-login" }

エラー#

エラーは、type と人が読める message を持つ JSON ボディを返します。メッセージには問題のあるフィールドの名前が含まれます。エラーもあわせて参照してください。

ステータス	`type`	発生する状況
`400`	`invalid_request_error`	ボディまたはパラメータが無効です（例：`"goal" is required (max 4,000 characters)`、`Unknown vault secret(s): …`、`Unknown file(s): …`、`Unknown profile "…"`）。
`401`	`authentication_error`	API キーがない、無効、失効済み、または期限切れです。
`402`	`insufficient_quota`	残高が実行の仮押さえ額に満たないか、仮押さえによってキーの利用上限を超えます。
`404`	`not_found`	該当する実行、シークレット、ファイル、プロファイル、スクリーンショットがアカウントにありません。
`409`	`invalid_request_error`	実行がこの返信を待っていない、実行が終了している、またはファイル数が 100 に達しています。
`413`	`invalid_request_error`	ファイルが 10 MB を超えているか、ボールトのシークレットが 4 KB を超えています。
`429`	`rate_limit_exceeded`	すでに 10 件の実行（ブラウザエージェントとデータツールの実行の合計）が進行中です。
`502`	`tool_unavailable`	実行を開始できませんでした。課金はされていません。もう一度お試しください。
`503`	`tool_unavailable`	ブラウザエージェントが一時的に利用できません。

Error

{
  "error": {
    "type": "invalid_request_error",
    "message": "\"start_url\" must be an http(s) URL"
  }
}