Remote Data Sources

Instead of sending all context rows inline, you can reference a remote CSV file via a pre-signed URL. The server fetches the CSV, parses it, downsamples to 2,048 rows if needed, merges it with the query rows you provide, and runs the prediction.

Works with any storage that serves CSV over HTTPS — S3, GCS, Azure Blob, BTP Object Store, MinIO, or anywhere else. No credentials are stored on our side; the URL itself carries the access grant.

Request Format

{
  "dataSource": {
    "type": "url",
    "url": "https://my-bucket.s3.amazonaws.com/sales_data.csv"
  },
  "index_column": "CUSTOMER_ID",
  "explanations": {
    "top_column_scores": 4,
    "top_relevant_context_rows": 3
  }
}

Request Parameters

• dataSource (required): Remote data source configuration.
  • dataSource.type (required): Provider type. Currently only "url" is supported.
  • dataSource.url (required): HTTPS URL to a CSV file. Must start with https://. Maximum 8,192 characters.
• index_column (optional): Same as inline mode.
• sampler_options (optional): Same as inline mode.
• explanations (optional): Same as inline mode.

Note: Query rows (rows) are not supported in remote data source mode. The CSV file must contain both context rows and query rows (with [PREDICT] placeholders).

Response Format

{
  "prediction": {
    "id": "51fe6c9d-f97f-428d-a59c-093046eb2bd6",
    "status": {
      "code": 0,
      "message": "ok"
    },
    "metadata": {
      "num_columns": 3,
      "num_predictions": 1,
      "num_query_rows": 1,
      "num_rows": 2049
    },
    "predictions": [
      {
        "CUSTOMER_ID": "C-1042",
        "DAYS_LATE": [
          {
            "prediction": 14.5,
            "confidence": null,
            "confidence_interval": [0, 42]
          }
        ]
      }
    ],
    "explanations": null
  },
  "delay": 520.1,
  "samplingMetadata": {
    "downsampled": true,
    "sampledFrom": 50000,
    "sampledTo": 2048,
    "strategy": "random"
  },
  "source": {
    "type": "url",
    "url": "https://my-bucket.s3.amazonaws.com/sales_data.csv"
  },
  "contextRows": {
    "fetched": 50000,
    "sampled": 2048,
    "strategy": "random",
    "downsampled": true
  }
}

Additional Response Fields

Fields specific to Remote Data Source mode:

• source (object):
  • source.type (string): Echoes the request's dataSource.type.
  • source.url (string): Echoes the request's dataSource.url.
• contextRows (object):
  • contextRows.fetched (integer): Number of context rows fetched from the remote URL.
  • contextRows.sampled (integer): Number of context rows actually sent to RPT-1.
  • contextRows.strategy (string): Sampling strategy used.
  • contextRows.downsampled (boolean): Whether downsampling occurred.

Limits

For env variable names, see Limits & Quotas.