---
title: "PATCH /migration/{tenantLocator}/migrations/{migrationLocator}"
method: PATCH
path: "/migration/{tenantLocator}/migrations/{migrationLocator}"
---

# PATCH /migration/{tenantLocator}/migrations/{migrationLocator}

`PATCH /migration/{tenantLocator}/migrations/{migrationLocator}`

## Request

- Base URL: `https://docs.socotra.com`
- URL: `https://docs.socotra.com/migration/{tenantLocator}/migrations/{migrationLocator}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/docs/migration/:tenantLocator/migrations/:migrationLocator/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `tenantLocator` string, uuid, required
- `migrationLocator` string, ulid, required

## Request body

- PatchAccountMigrationRequest
  - `defaultCreatedBy` string, uuid, required
  - `accountLocator` string, ulid, required
  - `accountData` AccountMigrationData
    - `id` string, required
    - `accountType` string, required
    - `data` object, required
    - `createdAt` string, date-time, required
    - `createdBy` string, uuid
    - `delinquencyPlanName` string
    - `autoRenewalPlanName` string
    - `excessCreditPlanName` string
    - `shortfallTolerancePlanName` string
    - `preferences` MigrationPreferences
      - `installmentPreferences` MigrationInstallmentPreferences
        - `cadence` 'none' | 'fullPay' | 'weekly' | 'everyOtherWeek' | 'monthly' | 'quarterly' | 'semiannually' | 'annually' | 'thirtyDays' | 'everyNDays'
        - `anchorMode` 'generateDay' | 'termStartDay' | 'dueDay'
        - `generateLeadDays` integer
        - `dueLeadDays` integer
        - `installmentWeights` number[], required
        - `maxInstallmentsPerTerm` integer
        - `installmentPlanName` string
        - `anchorType` 'none' | 'dayOfMonth' | 'anchorTime' | 'dayOfWeek' | 'weekOfMonth'
        - `dayOfMonth` integer
        - `dayOfWeek` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'
        - `weekOfMonth` 'none' | 'first' | 'second' | 'third' | 'fourth' | 'fifth'
        - `anchorTime` string, date-time
        - `autopayLeadDays` number
    - `billingLevel` 'account' | 'inherit' | 'policy'
  - `policies` object, required
  - `invoices` object, required
  - `payments` object, required
  - `disbursements` object, required

## Response `200`

OK

- MigrationFailuresResponse
  - `accountLocator` string, ulid, required
  - `accountOriginalId` string, required
  - `accountError` ErrorDetailsResponse
    - `originalId` string, required
    - `errors` ValidationResult, required
      - `validationItems` ValidationItemResponse[]
        - `elementType` string, required
        - `locator` string, ulid, required
        - `errors` string[], required
      - `success` boolean, required
  - `policies` object, required
  - `invoices` object, required
  - `payments` object, required
  - `disbursements` object, required

---

[API](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi.md) - [All operations](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/revisions/77ee7d8172b9?raw)