Create a calculation backfill

Overview

Create a calculation backfill. The calculation API repairs historical derived data and explains how calculated values were produced.

When to use it

• Use it when an application needs to create a calculation backfill.
• Use it when an engineer is validating derived data, diagnosing a rule, or repairing a historical calculation window.

Quick example

Set the base URL and replace generated identifiers or credentials with values from your installation.

curl --request POST \
  --url "$ORDINATE_URL/v1/calc/backfill" \
  --header "Authorization: Bearer $ORDINATE_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "rule_id": "00000000-0000-4000-8000-000000000001",
    "start_ns": 0,
    "end_ns": 0
  }'

{
  "job_id": "00000000-0000-4000-8000-000000000001"
}

The cURL request sends the smallest contract-derived body and asks OrdinateDB to create a calculation backfill. The documented 202 response is backfill accepted.

How it works

Reference

Required capability

calc-author

Authorization scope

handler-resolved target

{
  "rule_id": "00000000-0000-4000-8000-000000000001",
  "start_ns": 0,
  "end_ns": 0
}

{
  "job_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

Code examples

These examples are generated from the source contract. Replace the base URL, credentials, identifiers, and minimal generated values for your instance.

const ordinateUrl = "http://localhost:8080";
const token = "<bearer-token>";

const response = await fetch(`${ordinateUrl}/v1/calc/backfill`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "rule_id": "00000000-0000-4000-8000-000000000001",
  "start_ns": 0,
  "end_ns": 0
})
});

if (!response.ok) {
  throw new Error(`OrdinateDB returned ${response.status}: ${await response.text()}`);
}

const data = await response.json();
console.log(data);