Skip to main content
POST
Reassign the default StructVersion for a batch
Sets default_struct_version for new documents added to this batch. Existing rows keep the version they were extracted with until you reassign or reprocess them.

Authorizations

Authorization
string
header
required

Organisation API key from Settings → API / /api/keys/. The secret is shown once. Send Authorization: Bearer sk-abacus-…. One active key per organisation. Ingest (/api/v2/ingest/*) refuses API keys — that surface is Auth0-only with ingest:read / ingest:write scopes.

Path Parameters

batch_id
integer
required

Body

application/json

Body for batch version reassignment endpoints (Task 16).

Accepts a single version_number field; the consuming view resolves it against the parent batch's struct and rejects deprecated versions.

version_number
integer
required
Required range: x >= 1

Response

List shape for StructVersion rows (no schema body).

version_number
integer
required
Required range: 0 <= x <= 2147483647
published_at
string<date-time>
required
read-only
published_by
object | null
required

Compact projection of the user who published / deprecated a version.

field_count
integer
required
read-only
is_deprecated
boolean
required
read-only
deprecated_by
object | null
required

Compact projection of the user who published / deprecated a version.

publish_note
string
Maximum string length: 500
deprecated_at
string<date-time> | null
deprecation_note
string
Maximum string length: 500