{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
Transactions
Update transaction
Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
Authorizations
ApiKeyAuthGrainOAuth2BearerAuth
Authorization
string
header
required
Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.
Headers
X-Organization-Id
string
Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.
Path Parameters
id
string
required
Resource ID
Body
application/json
All fields are optional. Amount, type, bank account, cash account, and fund cannot change once the transaction is coded; uncategorize it first.
description
string
Minimum string length: 1
amount
number
Required range: x >= 0
date
string<date>
transactionType
enum<string>
Available options:
DEPOSIT,
WITHDRAWAL,
TRANSFER,
ADJUSTMENT
referenceNumber
string
bankAccountId
string
accountId
string
fundId
string
vendorId
string | null
is1099Excluded
boolean
foreignCurrency
string | null
foreignAmount
number | null
exchangeRate
number | null
Response
Updated transaction
id
string
required
externalId
string | null
required
Integrator-supplied ID, unique within the organization.
description
string
required
amount
number
required
Always positive. Use direction for the sign.
Required range: x >= 0
direction
enum<string>
required
Available options:
INFLOW,
OUTFLOW
transactionType
enum<string>
required
Available options:
DEPOSIT,
WITHDRAWAL,
TRANSFER,
ADJUSTMENT
date
string<date-time>
required
Calendar day represented as a UTC-midnight ISO timestamp.
referenceNumber
string | null
required
source
enum<string>
required
Available options:
MANUAL,
PLAID,
IMPORT,
PLANNING_CENTER,
PUSHPAY,
TITHELY,
SUBSPLASH,
ROCK_RMS,
RAMP,
DIVVY,
OVERFLOW
reviewStatus
enum<string>
required
Available options:
DRAFT,
PENDING_REVIEW,
PENDING_TRANSFER_MATCH,
PENDING_TRANSFER_CONFIRM,
AUTO_CATEGORIZED,
APPROVED,
POSTED,
REJECTED
isReconciled
boolean
required
is1099Excluded
boolean
required
bankAccount
object | null
required
Connected bank or card feed, when the transaction came from one.
Hide child attributes
bankAccount.id
string
required
bankAccount.name
string
required
bankAccount.mask
string | null
required
bankAccount.accountType
string | null
required
sourceAccount
object | null
required
Ledger cash, bank, or card account the transaction clears through.
Hide child attributes
sourceAccount.id
string
required
sourceAccount.accountNumber
string | null
required
sourceAccount.name
string
required
sourceAccount.accountType
string | null
required
fund
object | null
required
Hide child attributes
fund.id
string
required
fund.name
string
required
fund.fundType
string | null
required
vendor
object | null
required
Hide child attributes
vendor.id
string
required
vendor.name
string
required
dimensions
object[]
required
Header dimensions for the transaction.
Hide child attributes
dimensions.dimensionId
string
required
dimensions.dimensionValueId
string
required
dimensions.dimensionName
string | null
read-only
dimensions.dimensionValueName
string | null
read-only
coding
object
required
Hide child attributes
coding.status
enum<string>
required
UNCATEGORIZED has no journal entry. CATEGORIZED has a draft entry. APPROVED has a posted entry.
Available options:
UNCATEGORIZED,
CATEGORIZED,
APPROVED
coding.journalEntryId
string | null
required
coding.entryNumber
string | null
required
coding.isSplit
boolean
required
coding.lines
object[]
required
Category-side journal lines. The bank or card line is omitted.
Hide child attributes
coding.lines.id
string
required
Journal entry line ID.
coding.lines.account
object | null
required
Hide child attributes
coding.lines.account.id
string
required
coding.lines.account.accountNumber
string | null
required
coding.lines.account.name
string
required
coding.lines.account.accountType
string | null
required
coding.lines.fund
object | null
required
Hide child attributes
coding.lines.fund.id
string
required
coding.lines.fund.name
string
required
coding.lines.fund.fundType
string | null
required
coding.lines.amount
number
required
Allocated amount. Positive values allocate the transaction; negative values offset another line.
coding.lines.memo
string | null
required
coding.lines.dimensions
object[]
required
Hide child attributes
coding.lines.dimensions.dimensionId
string
required
coding.lines.dimensions.dimensionValueId
string
required
coding.lines.dimensions.dimensionName
string | null
read-only
coding.lines.dimensions.dimensionValueName
string | null
read-only
coding.missingRequiredDimensions
object[]
required
Required dimensions that must be assigned before the transaction can be approved.
Hide child attributes
coding.missingRequiredDimensions.dimensionId
string
required
coding.missingRequiredDimensions.dimensionName
string
required
suggestion
object | null
required
Rule or AI coding suggestion awaiting review.
Hide child attributes
suggestion.account
object | null
required
Hide child attributes
suggestion.account.id
string
required
suggestion.account.accountNumber
string | null
required
suggestion.account.name
string
required
suggestion.account.accountType
string | null
required
suggestion.fund
object | null
required
Hide child attributes
suggestion.fund.id
string
required
suggestion.fund.name
string
required
suggestion.fund.fundType
string | null
required
suggestion.confidence
integer | null
required
Required range: 0 <= x <= 100
attachmentCount
integer
required
Required range: x >= 0
canManage
boolean
required
Whether this credential can edit the transaction.
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
Last modified on October 10, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Grain API","description":"Developer documentation for the Grain church accounting and donor management API.","colors":{"primary":"#03440c","light":"#4A806C","dark":"#3D6B5E"},"logo":{"light":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-light.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=47f8188964661273a33f4901a311ba81","dark":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-dark.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=b4689fb4f3c2b42f5e3e251f39b0bf76"},"favicon":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-logomark.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=e53c14afdfadd5aa05ef57a0c8f68985","api":{"openapi":["openapi.json"],"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"],"prefill":true,"autogenerate":true},"url":"full"},"search":{"prompt":"Search Grain API docs..."},"seo":{"metatags":{"og:site_name":"Grain API Docs","og:image":"https://grainledger.com/og-image.jpg?v=wheat-field-20260908","og:image:width":"1200","og:image:height":"630","twitter:card":"summary_large_image","twitter:image":"https://grainledger.com/og-image.jpg?v=wheat-field-20260908"},"indexing":"navigable"},"fonts":{"heading":{"family":"DM Sans","weight":600},"body":{"family":"DM Sans","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"posthog":{"apiKey":"phc_nev4txvApsir3qS4dQB5T7JvI46Zl0ZXSQHXpgo6IhD","apiHost":"https://us.i.posthog.com","sessionRecording":false}},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Open app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/grainledger/images/grain-logomark.svg","href":"https://app.grainledger.com"},{"anchor":"Support","icon":"circle-question","href":"https://grainledger.com/support"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"grainledger","hasAudioNarration":false,"actualSubdomain":"grainledger","customDomains":["docs.grainledger.com"],"gitSource":{"type":"github","owner":"grain-ledger","repo":"grain","deployBranch":"main","contentDirectory":"api-docs","isPrivate":true,"mountPath":"","label":"","_id":"6af23ed0ed34cff0851c7334"},"entitlements":{},"buildId":"6aca5e6adf7fb4ef9ef2ce28","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":59},{"language":"default","tag":"Transactions","count":14},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Households","count":8},{"language":"default","tag":"Core concepts","count":7},{"language":"default","tag":"Bills","count":5},{"language":"default","tag":"Contributions","count":5},{"language":"default","tag":"Donors","count":5},{"language":"default","tag":"Giving Batches","count":5},{"language":"default","tag":"Pledges","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/transactions/update-transaction","slug":"/api-reference/transactions/update-transaction","pageMetadata":{"title":"Update transaction","description":"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/transactions/{id}","href":"/api-reference/transactions/update-transaction","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Update transaction","description":"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/transactions/{id}","href":"/api-reference/transactions/update-transaction","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transactions"],"operationId":"updateTransaction","summary":"Update transaction","description":"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.","parameters":["ae16b794-f47a-40c0-8b54-d027e99db753","01a43d03-ad06-42d1-8ee8-e4c7d44ebfc7"],"requestBody":"48a1b23c-a3c0-4ba5-bb4e-c48ed4587044","responses":{"200":"c757d8a1-3512-44ec-8aac-03f98847ec71","400":"3011582e-5ffc-4508-83c9-e7d5a21d8099","401":"8a50a507-625d-4275-a4b5-75946c45b5f6","403":"2f58a2d2-2579-4a65-9494-58fb37d9b8c9","404":"04fb84e4-b852-4910-a037-922674d733c4","409":"341a725e-f041-4a82-b642-aa5b824000c3","422":"f68a4a02-5e20-4f11-b004-a87074612a9e","429":"167ef0ee-3774-4719-a1bd-d39e0a9248b0","500":"ba4ce71e-fff8-4fb1-9314-b668d109a449"},"method":"patch","type":"path","servers":["f6713c7b-79dc-4516-9fa4-b80a2e5b565a"],"security":["b13aa5d4-77e1-4461-944f-0c8c2480e9b6","0a4ca29a-fd5e-40fa-afd3-39cd795826a4","5d65a984-a73a-4263-a6ec-edd6bb054d60"],"path":"/api/v1/transactions/{id}","baseUrlOptions":["https://api.grainledger.com"],"title":"Update transaction","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.description":"\u003cstring>","body.amount":1,"body.date":"2023-12-25","body.referenceNumber":"\u003cstring>","body.bankAccountId":"\u003cstring>","body.accountId":"\u003cstring>","body.fundId":"\u003cstring>","body.vendorId.oneOf.0":"\u003cstring>","body.is1099Excluded":true,"body.foreignCurrency.oneOf.0":"\u003cstring>","body.foreignAmount.oneOf.0":123,"body.exchangeRate.oneOf.0":123}],"urlDisplay":"full"},"dependencies":{"parameters":{"ae16b794-f47a-40c0-8b54-d027e99db753":{"name":"X-Organization-Id","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.","uniqueKey":"","typeLabel":"string"},"description":"Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.","example":"cm123abc456def"},"01a43d03-ad06-42d1-8ee8-e4c7d44ebfc7":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Resource ID","uniqueKey":"","typeLabel":"string"},"description":"Resource ID","example":"cm456def789ghi"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"All fields are optional. Amount, type, bank account, cash account, and fund cannot change once the transaction is coded; uncategorize it first.","properties":{"description":{"type":"string","minLength":1,"uniqueKey":"description","typeLabel":"string"},"amount":{"type":"number","minimum":0,"uniqueKey":"amount","typeLabel":"number"},"date":{"type":"string","format":"date","uniqueKey":"date","typeLabel":"string\u003cdate>"},"transactionType":{"type":"string","enum":["DEPOSIT","WITHDRAWAL","TRANSFER","ADJUSTMENT"],"uniqueKey":"transactionType","typeLabel":"enum\u003cstring>"},"referenceNumber":{"type":"string","uniqueKey":"referenceNumber","typeLabel":"string"},"bankAccountId":{"type":"string","uniqueKey":"bankAccountId","typeLabel":"string"},"accountId":{"type":"string","uniqueKey":"accountId","typeLabel":"string"},"fundId":{"type":"string","uniqueKey":"fundId","typeLabel":"string"},"vendorId":{"oneOf":[{"type":"string","uniqueKey":"vendorId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"vendorId.oneOf.1","typeLabel":"null"}],"uniqueKey":"vendorId","typeLabel":"string | null"},"is1099Excluded":{"type":"boolean","uniqueKey":"is1099Excluded","typeLabel":"boolean"},"foreignCurrency":{"oneOf":[{"type":"string","uniqueKey":"foreignCurrency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"foreignCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"foreignCurrency","typeLabel":"string | null"},"foreignAmount":{"oneOf":[{"type":"number","uniqueKey":"foreignAmount.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"foreignAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"foreignAmount","typeLabel":"number | null"},"exchangeRate":{"oneOf":[{"type":"number","uniqueKey":"exchangeRate.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"exchangeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"exchangeRate","typeLabel":"number | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"description":"\u003cstring>","amount":1,"date":"2023-12-25","referenceNumber":"\u003cstring>","bankAccountId":"\u003cstring>","accountId":"\u003cstring>","fundId":"\u003cstring>","vendorId":"\u003cstring>","is1099Excluded":true,"foreignCurrency":"\u003cstring>","foreignAmount":123,"exchangeRate":123}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c757d8a1-3512-44ec-8aac-03f98847ec71":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Updated transaction","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id","externalId","description","amount","direction","transactionType","date","referenceNumber","source","reviewStatus","isReconciled","is1099Excluded","bankAccount","sourceAccount","fund","vendor","dimensions","coding","suggestion","attachmentCount","canManage","createdAt","updatedAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"externalId":{"oneOf":[{"type":"string","description":"Integrator-supplied ID, unique within the organization.","isRequired":true,"uniqueKey":"externalId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Integrator-supplied ID, unique within the organization.","isRequired":true,"uniqueKey":"externalId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"externalId","typeLabel":"string | null"},"description":{"type":"string","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"amount":{"type":"number","minimum":0,"description":"Always positive. Use direction for the sign.","isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"direction":{"type":"string","enum":["INFLOW","OUTFLOW"],"isRequired":true,"uniqueKey":"direction","typeLabel":"enum\u003cstring>"},"transactionType":{"type":"string","enum":["DEPOSIT","WITHDRAWAL","TRANSFER","ADJUSTMENT"],"isRequired":true,"uniqueKey":"transactionType","typeLabel":"enum\u003cstring>"},"date":{"type":"string","format":"date-time","description":"Calendar day represented as a UTC-midnight ISO timestamp.","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate-time>"},"referenceNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"referenceNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"referenceNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"referenceNumber","typeLabel":"string | null"},"source":{"type":"string","enum":["MANUAL","PLAID","IMPORT","PLANNING_CENTER","PUSHPAY","TITHELY","SUBSPLASH","ROCK_RMS","RAMP","DIVVY","OVERFLOW"],"isRequired":true,"uniqueKey":"source","typeLabel":"enum\u003cstring>"},"reviewStatus":{"type":"string","enum":["DRAFT","PENDING_REVIEW","PENDING_TRANSFER_MATCH","PENDING_TRANSFER_CONFIRM","AUTO_CATEGORIZED","APPROVED","POSTED","REJECTED"],"isRequired":true,"uniqueKey":"reviewStatus","typeLabel":"enum\u003cstring>"},"isReconciled":{"type":"boolean","isRequired":true,"uniqueKey":"isReconciled","typeLabel":"boolean"},"is1099Excluded":{"type":"boolean","isRequired":true,"uniqueKey":"is1099Excluded","typeLabel":"boolean"},"bankAccount":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","mask","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.name","typeLabel":"string"},"mask":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.mask.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.mask.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccount.oneOf.0.mask","typeLabel":"string | null"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"bankAccount.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccount.oneOf.0.accountType","typeLabel":"string | null"}},"description":"Connected bank or card feed, when the transaction came from one.","isRequired":true,"uniqueKey":"bankAccount.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","mask","accountType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"mask":{"oneOf":[{"type":"string"},{"type":"null"}]},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Connected bank or card feed, when the transaction came from one.","isRequired":true,"uniqueKey":"bankAccount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccount","typeLabel":"object | null"},"sourceAccount":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.id","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountNumber","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.name","typeLabel":"string"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceAccount.oneOf.0.accountType","typeLabel":"string | null"}},"description":"Ledger cash, bank, or card account the transaction clears through.","isRequired":true,"uniqueKey":"sourceAccount.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Ledger cash, bank, or card account the transaction clears through.","isRequired":true,"uniqueKey":"sourceAccount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceAccount","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fund","typeLabel":"object | null"},"vendor":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"vendor.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"vendor.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"vendor.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"isRequired":true,"uniqueKey":"vendor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vendor","typeLabel":"object | null"},"dimensions":{"type":"array","description":"Header dimensions for the transaction.","items":{"type":"object","additionalProperties":false,"required":["dimensionId","dimensionValueId"],"properties":{"dimensionId":{"type":"string","isRequired":true,"uniqueKey":"dimensions.items.[INDEX].dimensionId","typeLabel":"string"},"dimensionValueId":{"type":"string","isRequired":true,"uniqueKey":"dimensions.items.[INDEX].dimensionValueId","typeLabel":"string"},"dimensionName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionName.oneOf.1","typeLabel":"null"}],"uniqueKey":"dimensions.items.[INDEX].dimensionName","typeLabel":"string | null"},"dimensionValueName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionValueName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"dimensions.items.[INDEX].dimensionValueName.oneOf.1","typeLabel":"null"}],"uniqueKey":"dimensions.items.[INDEX].dimensionValueName","typeLabel":"string | null"}},"uniqueKey":"dimensions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"dimensions","typeLabel":"object[]"},"coding":{"type":"object","additionalProperties":false,"required":["status","journalEntryId","entryNumber","isSplit","lines","missingRequiredDimensions"],"properties":{"status":{"type":"string","enum":["UNCATEGORIZED","CATEGORIZED","APPROVED"],"description":"UNCATEGORIZED has no journal entry. CATEGORIZED has a draft entry. APPROVED has a posted entry.","isRequired":true,"uniqueKey":"coding.status","typeLabel":"enum\u003cstring>"},"journalEntryId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.journalEntryId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.journalEntryId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.journalEntryId","typeLabel":"string | null"},"entryNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.entryNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.entryNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.entryNumber","typeLabel":"string | null"},"isSplit":{"type":"boolean","isRequired":true,"uniqueKey":"coding.isSplit","typeLabel":"boolean"},"lines":{"type":"array","description":"Category-side journal lines. The bank or card line is omitted.","items":{"type":"object","additionalProperties":false,"required":["id","account","fund","amount","memo","dimensions"],"properties":{"id":{"type":"string","description":"Journal entry line ID.","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].id","typeLabel":"string"},"account":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.id","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountNumber","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.name","typeLabel":"string"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0.accountType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].account","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].fund","typeLabel":"object | null"},"amount":{"type":"number","description":"Allocated amount. Positive values allocate the transaction; negative values offset another line.","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].amount","typeLabel":"number"},"memo":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].memo.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].memo.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].memo","typeLabel":"string | null"},"dimensions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["dimensionId","dimensionValueId"],"properties":{"dimensionId":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionId","typeLabel":"string"},"dimensionValueId":{"type":"string","isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueId","typeLabel":"string"},"dimensionName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionName.oneOf.1","typeLabel":"null"}],"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionName","typeLabel":"string | null"},"dimensionValueName":{"oneOf":[{"type":"string","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueName.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueName.oneOf.1","typeLabel":"null"}],"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX].dimensionValueName","typeLabel":"string | null"}},"uniqueKey":"coding.lines.items.[INDEX].dimensions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"coding.lines.items.[INDEX].dimensions","typeLabel":"object[]"}},"uniqueKey":"coding.lines.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"coding.lines","typeLabel":"object[]"},"missingRequiredDimensions":{"type":"array","description":"Required dimensions that must be assigned before the transaction can be approved.","items":{"type":"object","additionalProperties":false,"required":["dimensionId","dimensionName"],"properties":{"dimensionId":{"type":"string","isRequired":true,"uniqueKey":"coding.missingRequiredDimensions.items.[INDEX].dimensionId","typeLabel":"string"},"dimensionName":{"type":"string","isRequired":true,"uniqueKey":"coding.missingRequiredDimensions.items.[INDEX].dimensionName","typeLabel":"string"}},"uniqueKey":"coding.missingRequiredDimensions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"coding.missingRequiredDimensions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"coding","typeLabel":"object"},"suggestion":{"oneOf":[{"type":"object","additionalProperties":false,"required":["account","fund","confidence"],"description":"Rule or AI coding suggestion awaiting review.","properties":{"account":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.id","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountNumber","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.name","typeLabel":"string"},"accountType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0.accountType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.account","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.fund","typeLabel":"object | null"},"confidence":{"oneOf":[{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"suggestion.oneOf.0.confidence.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"suggestion.oneOf.0.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion.oneOf.0.confidence","typeLabel":"integer | null"}},"isRequired":true,"uniqueKey":"suggestion.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["account","fund","confidence"],"description":"Rule or AI coding suggestion awaiting review.","properties":{"account":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null","additionalProperties":false,"required":["id","accountNumber","name","accountType"],"properties":{"id":{"type":"string"},"accountNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"accountType":{"oneOf":[{"type":"string"},{"type":"null"}]}}}]},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}}}]},"confidence":{"oneOf":[{"type":"integer","minimum":0,"maximum":100},{"type":"null","minimum":0,"maximum":100}]}},"isRequired":true,"uniqueKey":"suggestion.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"suggestion","typeLabel":"object | null"},"attachmentCount":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"attachmentCount","typeLabel":"integer"},"canManage":{"type":"boolean","description":"Whether this credential can edit the transaction.","isRequired":true,"uniqueKey":"canManage","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","externalId":"\u003cstring>","description":"\u003cstring>","amount":1,"direction":"INFLOW","transactionType":"DEPOSIT","date":"2023-11-07T05:31:56Z","referenceNumber":"\u003cstring>","source":"MANUAL","reviewStatus":"DRAFT","isReconciled":true,"is1099Excluded":true,"bankAccount":{"id":"\u003cstring>","name":"\u003cstring>","mask":"\u003cstring>","accountType":"\u003cstring>"},"sourceAccount":{"id":"\u003cstring>","accountNumber":"\u003cstring>","name":"\u003cstring>","accountType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"vendor":{"id":"\u003cstring>","name":"\u003cstring>"},"dimensions":[{"dimensionId":"\u003cstring>","dimensionValueId":"\u003cstring>","dimensionName":"\u003cstring>","dimensionValueName":"\u003cstring>"}],"coding":{"status":"UNCATEGORIZED","journalEntryId":"\u003cstring>","entryNumber":"\u003cstring>","isSplit":true,"lines":[{"id":"\u003cstring>","account":{"id":"\u003cstring>","accountNumber":"\u003cstring>","name":"\u003cstring>","accountType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"amount":123,"memo":"\u003cstring>","dimensions":[{"dimensionId":"\u003cstring>","dimensionValueId":"\u003cstring>","dimensionName":"\u003cstring>","dimensionValueName":"\u003cstring>"}]}],"missingRequiredDimensions":[{"dimensionId":"\u003cstring>","dimensionName":"\u003cstring>"}]},"suggestion":{"account":{"id":"\u003cstring>","accountNumber":"\u003cstring>","name":"\u003cstring>","accountType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"confidence":50},"attachmentCount":1,"canManage":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"3011582e-5ffc-4508-83c9-e7d5a21d8099":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Bad request (missing header or invalid input)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"8a50a507-625d-4275-a4b5-75946c45b5f6":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Unauthorized (missing or invalid Bearer token)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"2f58a2d2-2579-4a65-9494-58fb37d9b8c9":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Forbidden (no access to organization or action)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"04fb84e4-b852-4910-a037-922674d733c4":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"341a725e-f041-4a82-b642-aa5b824000c3":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Conflict (duplicate, cross-resource ownership conflict, concurrent change, or accounting-frozen resource)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"f68a4a02-5e20-4f11-b004-a87074612a9e":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"167ef0ee-3774-4719-a1bd-d39e0a9248b0":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"ba4ce71e-fff8-4fb1-9314-b668d109a449":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"}},"security":{"b13aa5d4-77e1-4461-944f-0c8c2480e9b6":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"grain_live_… or grain_test_…","description":"Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.","scopes":[],"schemeName":"ApiKeyAuth"}},"0a4ca29a-fd5e-40fa-afd3-39cd795826a4":{"GrainOAuth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.grainledger.com/auth/v1/oauth/authorize","tokenUrl":"https://auth.grainledger.com/auth/v1/oauth/token","scopes":{"openid":"OpenID Connect","email":"Email address","profile":"Profile information"}}},"scopes":[],"schemeName":"GrainOAuth2"}},"5d65a984-a73a-4263-a6ec-edd6bb054d60":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth access token (JWT)","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"f6713c7b-79dc-4516-9fa4-b80a2e5b565a":{"url":"https://api.grainledger.com","description":"API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"grain_live_… or grain_test_…","description":"Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.grainledger.com/auth/v1/oauth/authorize","tokenUrl":"https://auth.grainledger.com/auth/v1/oauth/token","scopes":{"openid":"OpenID Connect","email":"Email address","profile":"Profile information"}}},"scopes":[],"schemeName":"GrainOAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"GrainOAuth2","name":"Authorization"}],"title":"GrainOAuth2"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth access token (JWT)","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth access token (JWT)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"grainledger","siteName":"Grain API","title":"Update transaction - Grain API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T15:49:05.574Z","originalFileLocation":"api-reference/transactions/update-transaction.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Grain API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update transaction - Grain API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Grain API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.grainledger.com/api-reference/transactions/update-transaction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update transaction - Grain API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Grain API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03440c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.grainledger.com/api-reference/transactions/update-transaction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transactions/update-transaction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.grainledger.com/#organization\",\"name\":\"Grain API\",\"url\":\"https://docs.grainledger.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-light.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=47f8188964661273a33f4901a311ba81\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.grainledger.com#website\",\"name\":\"Grain API\",\"url\":\"https://docs.grainledger.com\",\"publisher\":{\"@id\":\"https://docs.grainledger.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction#webpage\",\"url\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction\",\"name\":\"Update transaction\",\"description\":\"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.\",\"dateModified\":\"2026-10-10T15:49:05.574Z\",\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://docs.grainledger.com/api-reference/transactions/list-transactions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update transaction\",\"item\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction#apireference\",\"headline\":\"Update transaction\",\"name\":\"Update transaction\",\"description\":\"Description, reference number, and date changes are copied to the linked journal entry. Changing the vendor re-attributes the journal entry.\",\"url\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.grainledger.com/api-reference/transactions/update-transaction#webpage\"},\"image\":\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\",\"dateModified\":\"2026-10-10T15:49:05.574Z\",\"publisher\":{\"@id\":\"https://docs.grainledger.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Grain API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Grain API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/transactions/update-transaction.md","siteName":"Grain API","nav":{"global":{"anchors":[{"anchor":"Open app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/grainledger/images/grain-logomark.svg","href":"https://app.grainledger.com"},{"anchor":"Support","icon":"circle-question","href":"https://grainledger.com/support"}]},"tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/intro"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Funds","pages":[{"title":"List funds","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/funds","href":"/api-reference/funds/list-funds"}]},{"group":"Coding Reference Data","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/accounts","href":"/api-reference/coding-reference-data/list-accounts"},{"title":"List dimensions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/dimensions","href":"/api-reference/coding-reference-data/list-dimensions"},{"title":"List vendors","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/vendors","href":"/api-reference/coding-reference-data/list-vendors"}]},{"group":"Organizations","pages":[{"title":"List authorized organizations","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/organizations","href":"/api-reference/organizations/list-authorized-organizations"}]},{"group":"Transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Create transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions","href":"/api-reference/transactions/create-transaction"},{"title":"Get transaction by ID","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}","href":"/api-reference/transactions/get-transaction-by-id"},{"title":"Delete transaction","description":"Reconciled transactions cannot be deleted.","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}","href":"/api-reference/transactions/delete-transaction"},{"title":"Update transaction","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/transactions/{id}","href":"/api-reference/transactions/update-transaction"},{"title":"Code or split a transaction","description":"Creates or replaces the transaction's draft journal entry. Approved transactions must be unapproved first, and reconciled transactions cannot be recoded. Returns 409 when the transaction is in an open reconciliation.","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/transactions/{id}/coding","href":"/api-reference/transactions/code-or-split-a-transaction"},{"title":"Uncategorize a transaction","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}/coding","href":"/api-reference/transactions/uncategorize-a-transaction"},{"title":"Set transaction dimensions","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/transactions/{id}/dimensions","href":"/api-reference/transactions/set-transaction-dimensions"},{"title":"Approve a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/approve","href":"/api-reference/transactions/approve-a-transaction"},{"title":"Unapprove a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/unapprove","href":"/api-reference/transactions/unapprove-a-transaction"},{"title":"List transaction attachments","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}/attachments","href":"/api-reference/transactions/list-transaction-attachments"},{"title":"Upload a receipt","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/attachments","href":"/api-reference/transactions/upload-a-receipt"},{"title":"Get an attachment download URL","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}/attachments/{fileId}/download","href":"/api-reference/transactions/get-an-attachment-download-url"},{"title":"Delete an attachment","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}/attachments/{fileId}","href":"/api-reference/transactions/delete-an-attachment"}]},{"group":"Bills","pages":[{"title":"List bills","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/bills","href":"/api-reference/bills/list-bills"},{"title":"Create bill","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/bills","href":"/api-reference/bills/create-bill"},{"title":"Get bill","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/bills/{id}","href":"/api-reference/bills/get-bill"},{"title":"Delete bill","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/bills/{id}","href":"/api-reference/bills/delete-bill"},{"title":"Update bill","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/bills/{id}","href":"/api-reference/bills/update-bill"}]},{"group":"Donors","pages":[{"title":"List donors","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/donors","href":"/api-reference/donors/list-donors"},{"title":"Create donor","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/donors","href":"/api-reference/donors/create-donor"},{"title":"Get donor","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/donors/{id}","href":"/api-reference/donors/get-donor"},{"title":"Delete donor","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/donors/{id}","href":"/api-reference/donors/delete-donor"},{"title":"Update donor","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/donors/{id}","href":"/api-reference/donors/update-donor"}]},{"group":"Contributions","pages":[{"title":"List contributions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/contributions","href":"/api-reference/contributions/list-contributions"},{"title":"Create contribution","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/contributions","href":"/api-reference/contributions/create-contribution"},{"title":"Get contribution","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/contributions/{id}","href":"/api-reference/contributions/get-contribution"},{"title":"Delete contribution","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/contributions/{id}","href":"/api-reference/contributions/delete-contribution"},{"title":"Update contribution","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/contributions/{id}","href":"/api-reference/contributions/update-contribution"}]},{"group":"Settlements","pages":[{"title":"List settlements","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements","href":"/api-reference/settlements/list-settlements"},{"title":"Create settlement","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/settlements","href":"/api-reference/settlements/create-settlement"},{"title":"Get settlement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements/{id}","href":"/api-reference/settlements/get-settlement"},{"title":"Delete settlement","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/settlements/{id}","href":"/api-reference/settlements/delete-settlement"},{"title":"Update settlement","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/settlements/{id}","href":"/api-reference/settlements/update-settlement"}]},{"group":"Giving Batches","pages":[{"title":"List giving batches","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/batches","href":"/api-reference/giving-batches/list-giving-batches"},{"title":"Create giving batch","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/batches","href":"/api-reference/giving-batches/create-giving-batch"},{"title":"Get giving batch","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/batches/{id}","href":"/api-reference/giving-batches/get-giving-batch"},{"title":"Delete giving batch","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/batches/{id}","href":"/api-reference/giving-batches/delete-giving-batch"},{"title":"Update giving batch","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/batches/{id}","href":"/api-reference/giving-batches/update-giving-batch"}]},{"group":"Pledge Card Imports","pages":[{"title":"Import pledge card data for review","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/pledge-card-imports","href":"/api-reference/pledge-card-imports/import-pledge-card-data-for-review"},{"title":"List pledge card import reference data","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledge-card-imports/reference-data","href":"/api-reference/pledge-card-imports/list-pledge-card-import-reference-data"}]},{"group":"Pledges","pages":[{"title":"List pledges","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledges","href":"/api-reference/pledges/list-pledges"},{"title":"Create pledge","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/pledges","href":"/api-reference/pledges/create-pledge"},{"title":"Get pledge","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledges/{id}","href":"/api-reference/pledges/get-pledge"},{"title":"Delete pledge","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/pledges/{id}","href":"/api-reference/pledges/delete-pledge"},{"title":"Update pledge","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/pledges/{id}","href":"/api-reference/pledges/update-pledge"}]},{"group":"Households","pages":[{"title":"List households","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/households","href":"/api-reference/households/list-households"},{"title":"Create household","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/households","href":"/api-reference/households/create-household"},{"title":"Get household","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/households/{id}","href":"/api-reference/households/get-household"},{"title":"Delete household","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/households/{id}","href":"/api-reference/households/delete-household"},{"title":"Update household","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/households/{id}","href":"/api-reference/households/update-household"},{"title":"Add household member","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/households/{id}/members","href":"/api-reference/households/add-household-member"},{"title":"Remove household member","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/households/{id}/members/{donorId}","href":"/api-reference/households/remove-household-member"},{"title":"Update household member","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/households/{id}/members/{donorId}","href":"/api-reference/households/update-household-member"}]}]}]},"basePath":"","title":"Update transaction - Grain API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}