Skip to main content
PATCH
Update accounting intelligence settings

Authorizations

X-API-Key
string
header
required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Body

application/json

Change how the accounting intelligence agent auto-codes a connection. Provide mode, enabledDimensionKeys, or both; omitted fields keep their current value.

connectionId
string

The connection to update. Optional when the legal entity has exactly one connection; required when it has several.

Example:

"accounting_connection_2rj4l7hmrrrcv"

mode
enum<string>

disabled stops auto-coding, all_fields codes every supported dimension, selected_fields codes only enabledDimensionKeys.

Available options:
disabled,
all_fields,
selected_fields
enabledDimensionKeys
string[]

The dimensions to auto-code when the resulting mode is selected_fields, where at least one key is required; each key must be in supportedDimensionKeys. With any other mode, send an empty list or exactly what GET reports for that mode (every supported key for all_fields, none for disabled), so the settings object can be sent back as read. The selection is kept only while the mode is selected_fields, so switching back to it needs the keys again.

Maximum array length: 50
Required string length: 1 - 255
Example:

Response

The settings as stored.

How the accounting intelligence agent auto-codes a connection's entries. The agent reads a transaction's merchant, card and history, proposes a value for each enabled dimension and writes it as an ai mapping, so its work shows up in GET /v2/accounting/mappings and can be corrected there.

connectionId
string
required
Example:

"accounting_connection_2rj4l7hmrrrcv"

mode
enum<string>
required

disabled never auto-codes. all_fields auto-codes every dimension in supportedDimensionKeys. selected_fields auto-codes only the dimensions chosen in enabledDimensionKeys.

Available options:
disabled,
all_fields,
selected_fields
enabledDimensionKeys
string[]
required

The dimensions the agent codes under the current mode: empty when disabled, every supported key when all_fields, the chosen keys when selected_fields.

Example:
supportedDimensionKeys
string[]
required

The dimensions the agent can code on this platform.

Example: