Get a knowledge source and its config
Retrieve one knowledge source and the configuration it was created with. Any role can read it; for its latest run, read the source’s latest job.
GET
/
knowledge
/
sources
/
{source_id}
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/knowledge/sources/5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
source_id = "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/knowledge/sources/{source_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const sourceId = '5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/knowledge/sources/${sourceId}`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
"source_type": "website",
"name": "Product documentation site",
"configuration": {
"seed_url": "https://docs.example.com/",
"path_prefix": "/guides",
"max_depth": "3",
"max_pages": "1000",
"include_paths": "",
"exclude_paths": "/guides/archive/"
},
"status": "active",
"last_source_version": null,
"last_ingested_at": null,
"created_at": "2026-09-24T10:16:30.119842",
"updated_at": "2026-09-24T10:16:30.119842"
}
{ "code": "not_found", "message": "The knowledge source was not found." }
Returns
404 both for an ID that does not exist and for a source that belongs to another organization. A malformed ID also returns 404. Any role in the organization can read a source.
To see the source’s latest ingestion run, call Get a source’s latest job. To rename, reconfigure, pause or resume it, call Update a source.
string
required
Source ID (a UUID).
Response
string
required
Source ID (a UUID).
string
required
Collection the source ingests into.
string
required
One of the
source_type values listed on Connectors, such as website,
github or upload.string
required
Display name.
object
required
Stored configuration. Every value is a string. See Create a
source.
boolean
required
Whether answers from this source are limited to what each reader may see in the source system. See
Source permissions.
boolean
required
Whether
respect_source_permissions can be turned on for this source.string
required
active, paused or disabled. Only an active source is ingested. A paused source keeps its
documents, and they are still answered from.string | null
required
Source version read by the last ingestion run that ended
succeeded or partial. null if never
ingested, and null again once the source’s configuration is edited, until the next such run.string | null
required
ISO 8601 timestamp in UTC of the last ingestion run that ended
succeeded or partial. null if
never ingested.string
required
ISO 8601 timestamp, in UTC.
string
required
ISO 8601 timestamp, in UTC.
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/knowledge/sources/5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
source_id = "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/knowledge/sources/{source_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const sourceId = '5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/knowledge/sources/${sourceId}`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
"source_type": "website",
"name": "Product documentation site",
"configuration": {
"seed_url": "https://docs.example.com/",
"path_prefix": "/guides",
"max_depth": "3",
"max_pages": "1000",
"include_paths": "",
"exclude_paths": "/guides/archive/"
},
"status": "active",
"last_source_version": null,
"last_ingested_at": null,
"created_at": "2026-09-24T10:16:30.119842",
"updated_at": "2026-09-24T10:16:30.119842"
}
{ "code": "not_found", "message": "The knowledge source was not found." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/knowledge/sources/5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
source_id = "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/knowledge/sources/{source_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const sourceId = '5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/knowledge/sources/${sourceId}`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"id": "5d1e7a90-3c4b-4f2a-8e61-7b9c0d2f4a13",
"collection_id": "0b6f2c14-8a3d-4e91-9c77-2f5b1d0a4e88",
"source_type": "website",
"name": "Product documentation site",
"configuration": {
"seed_url": "https://docs.example.com/",
"path_prefix": "/guides",
"max_depth": "3",
"max_pages": "1000",
"include_paths": "",
"exclude_paths": "/guides/archive/"
},
"status": "active",
"last_source_version": null,
"last_ingested_at": null,
"created_at": "2026-09-24T10:16:30.119842",
"updated_at": "2026-09-24T10:16:30.119842"
}
{ "code": "not_found", "message": "The knowledge source was not found." }