Create transaction definition

post

http://ingest.spektr.com/v1/transaction-definitions

Create a new transaction definition with a nested field schema, customer link declarations, and optional non-client-scoped partitions. Leaf field values must be one of: "string", "number", "ipAddress", "date", "array". Array fields accept only primitive elements (string, number, boolean, null). Each link txPath and partition txPath must resolve to a declared leaf field (link and partition paths may not target array fields). Partition types must not collide with link types.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

type

string

required

Unique transaction type identifier

fields

object

required

Nested structure where leaf values are "string", "number", "ipAddress", "date", or "array" (array elements must be primitives: string, number, boolean, or null)

link

array of objects

required

length between 1 and 16

How transactions of this type link to customers. At least one entry is required.

link*

type

string

required

Stable label that identifies this link type (e.g. "iban", "spektrId")

txPath

string

required

Dot-notation path into the transaction payload that resolves to a leaf field declared in "fields"

clientRecordPath

string

required

Declarative path on the client record this link matches (e.g. "data.iban", "_id")

direction

string

enum

required

Which side of the transaction this link represents

Allowed:

partitions

array of objects

length ≤ 16

Optional non-client-scoped aggregation partitions (e.g. device, IP). Each partition type must be distinct from every link type.

partitions

realTimeFields

array of strings

Optional whitelist of dot-notation paths into "fields". When present, only these fields are available for transaction monitoring rules. When absent, all declared fields are available.

realTimeFields

Responses

201

Transaction definition created successfully

400

Payload validation failed

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

500Transaction definition creation failed