curl -X POST "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/sources/urls" \
-H "X-API-Key: bot_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing"
],
"crawler": "crawl4ai"
}'
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/sources/urls`,
{
method: "POST",
headers: {
"X-API-Key": process.env.BOTCADENCE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
urls: [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing",
],
crawler: "crawl4ai",
}),
}
);
import os
import requests
response = requests.post(
f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/sources/urls",
headers={
"X-API-Key": os.environ["BOTCADENCE_API_KEY"],
"Content-Type": "application/json",
},
json={
"urls": [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing",
],
"crawler": "crawl4ai",
},
)
{
"status": "success",
"message": "URLs added successfully",
"data": null,
"status_code": 201
}
Sources
Upload URLs
Add knowledge-base sources from one or more page URLs
POST
/
organizations
/
{organization_id}
/
projects
/
{project_id}
/
sources
/
urls
curl -X POST "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/sources/urls" \
-H "X-API-Key: bot_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing"
],
"crawler": "crawl4ai"
}'
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/sources/urls`,
{
method: "POST",
headers: {
"X-API-Key": process.env.BOTCADENCE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
urls: [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing",
],
crawler: "crawl4ai",
}),
}
);
import os
import requests
response = requests.post(
f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/sources/urls",
headers={
"X-API-Key": os.environ["BOTCADENCE_API_KEY"],
"Content-Type": "application/json",
},
json={
"urls": [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing",
],
"crawler": "crawl4ai",
},
)
{
"status": "success",
"message": "URLs added successfully",
"data": null,
"status_code": 201
}
Adds URL sources to the project knowledge base and queues crawling/indexing. Returns
201 Created.
Authentication
string
required
Project API key for this organization and project. Format:
bot_live_…Path parameters
string
required
Organization ID. Must match the API key.
string
required
Project ID. Must match the API key.
Body
array
required
List of page URLs to ingest.
string
default:"crawl4ai"
Crawler engine:
crawl4ai or apify.Response
Success message confirming URLs were queued.data is typically null.
Errors
Unauthorized
Missing, invalid, or revoked API key.
Forbidden
API key is not authorized, or link quota exceeded.
curl -X POST "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/sources/urls" \
-H "X-API-Key: bot_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing"
],
"crawler": "crawl4ai"
}'
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/sources/urls`,
{
method: "POST",
headers: {
"X-API-Key": process.env.BOTCADENCE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
urls: [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing",
],
crawler: "crawl4ai",
}),
}
);
import os
import requests
response = requests.post(
f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/sources/urls",
headers={
"X-API-Key": os.environ["BOTCADENCE_API_KEY"],
"Content-Type": "application/json",
},
json={
"urls": [
"https://example.com/docs/getting-started",
"https://example.com/docs/pricing",
],
"crawler": "crawl4ai",
},
)
{
"status": "success",
"message": "URLs added successfully",
"data": null,
"status_code": 201
}