Skip to main content
POST
Reconcile a scenario's position rules to an absolute desired state

Authorizations

x-api-key
string
header
required

Raw API key shown once when created in the Allocait app (Settings > API keys). Send it verbatim in this header; the server stores and compares only its SHA-256 hash. Allocait generates every key: alc_ followed by 64 lowercase hex characters. Keys issued before 2026-10-10 are 64 hex characters with no prefix and keep working. A key may carry an expiry (90 days or 1 year, or never). A malformed, unknown, revoked or expired key gets 401 with no further detail, and a malformed one is refused before any lookup. Keys cannot be created through this API.

Path Parameters

id
string<uuid>
required

scenario_id

Body

application/json
rules
object[]
required

The full desired set of position rules for this scenario, each with its allocation band and, optionally, its position size range and short size range.

Response

Reconciliation result

success
boolean
scenario_id
string<uuid>
created
object[]
updated
object[]
deleted
object[]

Asset classes whose rule was removed because they were not in the desired set.

unchanged
object[]

Asset classes already matching the desired state. No write was made for these.