API Overview

Authentication

All API requests require authentication using your personal API token. Include it in the Authorization header:

Authorization: Bearer YOUR_TOKEN

Obtain and manage tokens in Settings.

Endpoint

POST /api/predict

Submit data for prediction using in-context learning. The model learns from example rows (context rows) and predicts values for query rows that contain the [PREDICT] placeholder.

Base URL: https://rpt.cloud.sap

Request Body

{
  "rows": [
    {
      "PRODUCT": "Laptop Pro",
      "CATEGORY": "Electronics",
      "SALESGROUP": "Enterprise"
    },
    {
      "PRODUCT": "Standing Desk",
      "CATEGORY": "Furniture",
      "SALESGROUP": "Office"
    },
    {
      "PRODUCT": "Wireless Headset",
      "CATEGORY": "Electronics",
      "SALESGROUP": "[PREDICT]"
    }
  ],
  "index_column": "PRODUCT",
  "scenario": "q1-forecast",
  "sampler_options": {
    "seed": 42
  },
  "explanations": {
    "top_column_scores": 4,
    "top_relevant_context_rows": 3
  },
  "context_mode": "default"
}

Request Parameters

• rows (required): Array of data rows. Each row is an object with column names as keys.
  • Context rows: Rows with complete data (no [PREDICT] values) used as examples
  • Query rows: Rows containing [PREDICT] placeholder values indicating what to predict
• index_column (optional): Column name to use as row identifier in the response
• scenario (optional): Scenario identifier for telemetry. Has no effect on prediction output. Maximum 100 characters.
• sampler_options (optional): Sampling configuration applied when context rows exceed the model limit.
  • sampler_options.seed (optional, integer >= 0): Seed for reproducible random downsampling.
• explanations (optional): Controls explainability data depth. See Explainability.
  • explanations.top_column_scores (optional, integer 1–20): Top feature importance scores per query row. Default: 4.
  • explanations.top_relevant_context_rows (optional, integer 1–20): Most relevant context row indices per query row. Default: 3.
• context_mode (optional, "default" | "deep"): Prediction depth for SAP-RPT-1.6. Default: "default" — best balance of accuracy and latency. "deep" trades higher latency for higher accuracy and only takes effect on the large model variant (sap-rpt-1.6-large) with large context sets (>8000 rows).

Note: Target columns and task type (classification vs regression) are auto-detected from the data. Columns containing [PREDICT] in query rows are automatically identified as prediction targets.

Constraints

Predict requests are subject to rate limits and short-term throttling (a burst limit that paces rapid-fire requests). Exceeding either returns 429 with a Retry-After header. See Limits & Quotas for exact values, and Errors for the error codes.

Available Endpoints

Only the /api/predict endpoint is available via API token authentication. Chat-RPT, what-if simulations, and conversational features are available exclusively through the web UI.