API Reference
List URL sources
GET /api/v1/knowledge-bases/:knowledgeBaseId/urls — submitted URLs and their crawl status.
GET /api/v1/knowledge-bases/{knowledgeBaseId}/urlsQuery parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cursor | string | No | The nextCursor from the previous page. |
Response
200 OK
{
"items": [
{
"sourceId": "c3a9…",
"url": "https://example.com/docs",
"type": "root",
"status": "ACTIVE",
"stopReason": null,
"pageCount": 42,
"createdAt": "2026-10-09T08:00:00Z"
}
],
"nextCursor": null
}A source is CRAWLING while pages are fetched, then ACTIVE once they are indexed, or FAILED. stopReason says why a crawl stopped early, for example the maxPages limit.
Errors
| Status | error | When |
|---|---|---|
403 | forbidden | Your key is scoped to a different project. |
404 | not_found | No such Knowledge Base in your organization. |