---
title: "Add Knowledge From Url"
method: POST
path: "/api/v1/shops/{shop_id}/knowledge/url"
tags: ["Brand Knowledge"]
---

# Add Knowledge From Url

`POST /api/v1/shops/{shop_id}/knowledge/url`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/v1/shops/{shop_id}/knowledge/url`
- Auth: none declared. Required headers: `authorization`

Direct URL → save (Phase 1a-iii: 非同期化, 即 202 + 完了通知).

UX 改善: URL summarize + brand_knowledge insert は LLM call を含む
ため 5-30 秒待ちになる. ユーザーを待たせず即 202 を返し、background
task で処理 + 完了で右上ベル通知 (1a-i で配線済).

## Path parameters

- `shop_id` string, required

## Headers

- `authorization` string, required: Bearer <token>

## Request body

- PreviewURLRequest: Step 1: Preview URL summary before saving.
  - `url` string, required
  - `category` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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