---
title: "Add knowledge from a URL"
method: POST
path: "/knowledge/url"
tags: ["Knowledge"]
---

# Add knowledge from a URL

`POST /knowledge/url`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/knowledge/url`
- Auth: HTTP bearer

Ingest a standalone URL into current indexed knowledge (may fetch external content and embed it). For managed multi-page websites and refresh/selection use create_knowledge_website. This does not expose an in-place URL edit. Read returned sourceId, active/quotaExceeded and get_knowledge_source/get_knowledge_usage; accepted ingestion is not proof of relevance or historical use. Required permission: knowledge:write.

## Request body

- KnowledgeUrlInput
  - `url` string, uri, required

## Response `200`

Success

- KnowledgeIngestResponse
  - `sourceId` string
  - `chunks` integer
  - `created` boolean
  - `active` boolean
  - `quotaExceeded` boolean
  - `quota` object

## Other responses

- `201`: Success
- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)