Clone a reconciliation context

Use this endpoint to clone an existing reconciliation context with its associated sources, rules, and fee schedules. You can selectively include or exclude specific components.

POST /v1/contexts/{contextId}/clone

Clone a reconciliation context

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/contexts/{contextId}/clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Bank Reconciliation Q1 (Copy)",
  "includeRules": true,
  "includeSources": true
}
'

201

Example

{
  "context": {
    "autoMatchOnUpload": false,
    "createdAt": "2025-01-15T10:30:00Z",
    "feeToleranceAbs": "0.50",
    "feeTolerancePct": "0.5",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Bank Reconciliation Q1",
    "signConvention": "SAME",
    "status": "ACTIVE",
    "tenantId": "550e8400-e29b-41d4-a716-446655440000",
    "type": "1:1",
    "updatedAt": "2025-01-15T10:30:00Z",
    "agedBreakCalendar": "BR_ANBIMA",
    "agedBreakThresholdDays": 30,
    "feeNormalization": "NET"
  },
  "feeRulesCloned": 2,
  "fieldMapsCloned": 3,
  "rulesCloned": 5,
  "sourcesCloned": 3
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

X-Idempotency · string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409 (MTCH-0018), a key whose earlier attempt already ran but whose answer cannot be replayed returns 409 (MTCH-0022), and an idempotency storage failure returns 500. POST, PUT, PATCH and DELETE requests accept the header. These refusals are problem documents.

Parámetros de ruta

contextId · string<uuid> · requerido

The unique identifier of the reconciliation context to clone. Context ID

Cuerpo

application/json

Clone context payload

name · string · requerido

Name for the newly cloned context.

Required string length: 1 - 100

Ejemplo:

"Bank Reconciliation Q1 (Copy)"

includeRules · boolean

Whether to clone match rules and fee rules. Defaults to true when omitted.

Ejemplo:

true

includeSources · boolean

Whether to clone sources and their field maps. Defaults to true when omitted.

Ejemplo:

true

Respuesta

201

application/json

Successfully cloned context.

context · object · requerido

The newly created context.

Show child attributes

feeRulesCloned · integer<int64> · requerido

Number of fee rules cloned into the new context.

Ejemplo:

2

fieldMapsCloned · integer<int64> · requerido

Number of field maps cloned into the new context.

Ejemplo:

3

rulesCloned · integer<int64> · requerido

Number of match rules cloned into the new context.

Ejemplo:

5

sourcesCloned · integer<int64> · requerido

Number of sources cloned into the new context.

Ejemplo:

3