previewDataSource

POST

/api/v1/data-sources/{provider}/preview

const url = 'https://example.com/api/v1/data-sources/calendar/preview';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"configuration":{},"previewDate":"2026-04-15"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/v1/data-sources/calendar/preview \
  --header 'Content-Type: application/json' \
  --data '{ "configuration": {}, "previewDate": "2026-04-15" }'

Fetches and parses a candidate Data Source configuration under the safe fetch policy without saving raw data. A previewDate exercises date-aware selection.

Parameters

Path Parameters

provider

required

Allowed values: calendar rss atom json csv manual weather transit cap_alerts air_quality

Request Body^required

application/json

object

configuration

required

object

previewDate

string format: date

Example^generated

{
  "configuration": {},
  "previewDate": "2026-04-15"
}

Responses

200

Sanitized real-data preview and typed diagnostics

404

Data Source provider not found

422

Validation or safe fetch failed