/projects/{id}/reconciliations
A CSV or XLSX carrying a uid or hashed uid column. Accepted header aliases: uid, hashed uid, hasheduid, hashed_uid. Max file size 20 MB.
202 Accepted, and autoApprove is hard-coded false. The upload lands as PENDING and changes nothing until an admin approves it on the main dashboard. A client approving its own reconciliation would let it reclassify its own traffic unilaterally, which is the entire reason that review step exists.
Requires S3 to be configured (app.aws.*): the file goes to S3 before the row is written. This is also the one write path that is deliberately not transactional — a rolled-back transaction cannot un-upload an S3 object.
https://dashboard.a2bsample.com/api/developer/playground/client/projects/{projectId}/reconciliationsAuthorizationandX-Api-Tokenas headers./projects/{id}/reconciliationshttps://dashboard.a2bsample.com/api/developer/playground/client/projects/{projectId}/reconciliationsmissing projectId
Send a request to see the response.
Example request
Request
Headers4
AuthorizationstringrequiredThe secret half. A client token starts clt_ — the four-character prefix says which table to resolve it in, so the row it matches is the caller. A vnd_… token on this prefix is a 403, not a 404.
X-Api-TokenstringrequiredThe identity half — this client's own 40-hex apiToken, the value GET /api/developer/me echoes back. Compared in constant time against the bearer token's own row, so a bearer token lifted on its own is not enough to call the playground.
Content-TypestringrequiredRequest media type.
AcceptstringoptionalResponse media type.
Path parameters1
projectIdstring<uuid>requiredProject identifier. Ownership-checked in the service, never trusted from the URL.
Body1
filestring<binary>requiredThe CSV or XLSX to reconcile against. Max 20 MB.
Responses
Accepted and stored as PENDING. Nothing has been parsed and no hit has changed.
successboolean- Whether the call succeeded.
messagestringreconciliationobject- One reconcile submission and where it sits in the review lifecycle. Only an approval ever parses the file or changes a hit — nothing is automatic.