ServicesScanDALHTTP APIWrites

Write a mirrored file

POST
/writes/aligned

Write the mirror of one file of a version of another Table, as an Enrichment's values are written, so a scan of that version can read it at its own positions. The service writes the rows as they arrive, holding what it has not yet written in the request's memory budget. The mirror stays invisible until a version that includes its receipt is prepared on an aligned base, registered and committed.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Header Parameters

scandal-request*string

The WriteAlignedRequest request as JSON, base64url-encoded without padding.

Request Body

body*fileapplication/vnd.apache.arrow.stream
Formatbinary

Response Body

Success

application/json
  1. response

The receipt of a mirrored file, to finalize on an aligned base.

receipt*

One file an append wrote. Pass it unchanged to finalize a write.

curl -X POST 'https://scandal.spiraldb.dev/writes/aligned' \  -H 'scandal-request: string'
{  "receipt": {    "token": "string"  }}