Moss - Real-time Semantic Search for Conversational AI

Update a web source’s refresh cadence. daily and weekly schedule automatic re-crawls; manual clears the schedule so the source is only re-crawled via resyncWebSource. Cadence changes take effect immediately and reset the clock: the next scheduled run becomes now plus the new interval. Scheduled refreshes run on a rolling interval from the last completed run (there is no time-of-day control). Required fields: sourceId, refreshCadence

Field	Type	Required	Notes
`sourceId`	string	✅	Web source ID returned by `createWebSource` or `listWebSources`.
`refreshCadence`	string	✅	One of `daily`, `weekly`, `manual`.

Example request

curl -X POST "https://service.usemoss.dev/v1/manage" \
  -H "Content-Type: application/json" \
  -H "x-service-version: v1" \
  -H "x-project-key: moss_access_key_xxxxx" \
  -d '{
    "action": "updateWebSource",
    "projectId": "project_123",
    "sourceId": "7f2a9c04-3b1e-4c8a-9d2f-1e5b6a7c8d90",
    "refreshCadence": "daily"
  }'

Responses

{
  "id": "7f2a9c04-3b1e-4c8a-9d2f-1e5b6a7c8d90",
  "indexName": "docs-site",
  "rootUrl": "https://docs.yoursite.com",
  "maxPages": 500,
  "maxDocuments": 50000,
  "maxDepth": 3,
  "respectRobots": true,
  "parseDocuments": true,
  "refreshCadence": "daily",
  "nextRefreshAt": "2026-09-02T10:15:00.000+00:00",
  "lastCrawledAt": "2026-09-01T10:12:41.000+00:00",
  "lastPageCount": 214,
  "lastDocCount": 1893,
  "status": "idle",
  "lastErrorCode": null,
  "createdAt": "2026-09-01T10:00:00.000+00:00"
}

Errors

400 when sourceId is missing or refreshCadence is not daily, weekly, or manual.
404 if the web source is not found.

Getting Started

Index Management

Web Sources

Document Operations

Update Web Source