Create a scheduled crawl

POST 
/api/v1/chatbots/:chatbotId/scheduled-crawls

Creates a recurring scheduled crawl that re-ingests the given URLs into the chatbot's knowledge base on the chosen cadence. dayOfWeek is required for weekly; dayOfMonth (1-28) for monthly. Limited to 3 schedules per chatbot and 100 URLs per schedule (a violation returns 400). Requires admin-level chatbot access. Required scope: documents:write.

Request

Responses

201

Scheduled crawl created.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

429

Too Many Requests — rate limit exceeded