Set unix offset

Anchor all of this session’s data to wall-clock time.

Every partition inside the slice this session holds of each of its files takes unix_epoch_offset_ns as the wall-clock instant of its stored time 0, and the session’s aggregate bounds are recomputed from the moved data. Data that has never been anchored carries an offset of 0, so its stored timestamps already read as nanoseconds since the Unix epoch. Last writer wins: whatever anchor the data carried before is overwritten. The offset is a time after the Unix epoch: an integer of nanoseconds since the epoch, or any time roboto.time.to_epoch_nanoseconds reads, so a float or numeric string is seconds and an ISO 8601 string is that instant. Returning a session to an offset of 0 is the DELETE on this path. Setting the anchor the data already carries changes nothing and succeeds.

The write reaches this session’s data and no further. Where several sessions share one file, the slices this session does not hold keep their own anchors; the slices it does hold are shared rather than copied, so every other session over that data reads the anchor written here. The time range the session declares over a file is stored in anchored time and moves with its data, but only when every partition that range covers carries one offset before the write and one after; a range whose data disagrees on where it started has no single distance to move by, and stays where it is.

Returns the session with its recomputed bounds.

Four cases yield a 400: an offset that is not a time strictly between the Unix epoch and 263 ns, a session with no topic data, a session whose data already carries several distinct anchors (anchor one file or one topic at a time instead), and an anchor that would move the session’s data, or a time range declared over it, before the Unix epoch or past the largest storable instant (263 - 1 ns). A concurrent writer adding data to the session yields a 409; retry the request.

Access control

• Restricted tokens need the API scope api.everything_else

curl -X POST 'https://api.roboto.ai/v1/sessions/id/string/unix-offset' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "unix_epoch_offset_ns": 0
}'

const response = await fetch("https://api.roboto.ai/v1/sessions/id/string/unix-offset", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"unix_epoch_offset_ns\": 0\n}"
});

import requests

response = requests.post(
    "https://api.roboto.ai/v1/sessions/id/string/unix-offset",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"unix_epoch_offset_ns\": 0\n}",
)

{
  "data": {
    "completed_at": null,
    "completed_by": null,
    "completes_at": null,
    "completion_policy": null,
    "created": null,
    "created_by": "string",
    "custom_fields": {},
    "description": null,
    "ingested_at": null,
    "ingestion_count": 0,
    "max_timestamp_ns": null,
    "metadata": {},
    "min_timestamp_ns": null,
    "modified": null,
    "modified_by": "string",
    "name": null,
    "org_id": "string",
    "session_id": "string",
    "status": "in_progress",
    "tags": [
      "string"
    ]
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}

{
  "error": {
    "error_code": 0,
    "message": "string",
    "stack_trace": "string"
  }
}