All API resources
API reference
Change sets
Proposed journals and reconciliations that an admin approves before they reach the ledger.
Base URL https://app.prosaic.works/api/public/v1. Every request needs an API key or access token; see the overview.
Submit a change-set (proposed financial writes) for an entity
POST
/api/public/v1/entities/{entityId}/change-setsSDK: prosaic.changeSets.create(entityId, params)
Records an agent-proposed set of write operations (journal.post and/or reconcile) as a PENDING change-set. Idempotent on the content hash — re-submitting identical content returns the existing change-set. The set is NOT committed here; an admin approves it (L1) before it hits the ledger. The read-only box token is permitted on this single write path and remains pinned to its entity.
Path parameters
entityIdstringrequired
Request body
application/json
operationsarray of objectsrequiredsessionIdstringagentSessionIdstring
Responses
201 Successful response
successbooleanrequiredOne of:
truedataobjectrequiredShow 3 child attributesHide child attributes
idstringrequiredstatusstringrequiredcontentHashstringrequired
400Invalid body401Unauthorized403TOKEN_READ_ONLY / TOKEN_ENTITY_MISMATCH / ENTITY_ACCESS_DENIED404Entity has no workspace422CHANGE_SET_INVALID — an operation failed validation (e.g. amounts do not sum500Failed to record the change-set
Node SDK
const { data } = await prosaic.changeSets.create(entityId, {
operations: [
{
type: 'journal.post',
payload: {
narration: 'Office supplies',
date: '2026-04-01',
lines: [
{},
],
},
},
],
});curl
curl -X POST https://app.prosaic.works/api/public/v1/entities/$ENTITY_ID/change-sets \
-H "Authorization: Bearer $PROSAIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"operations": [
{
"type": "journal.post",
"payload": {
"narration": "Office supplies",
"date": "2026-04-01",
"lines": [
{}
]
}
}
]
}'