---
title: "PATCH /policy/{tenantLocator}/transactions/{locator}/elements"
method: PATCH
path: "/policy/{tenantLocator}/transactions/{locator}/elements"
---

# PATCH /policy/{tenantLocator}/transactions/{locator}/elements

`PATCH /policy/{tenantLocator}/transactions/{locator}/elements`

## Request

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

## Path parameters

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

## Request body

- ElementUpdateRequest
  - `locator` string, ulid, required
  - `setData` object, required
  - `removeData` object, required
  - `setCoverageTerms` object, required
  - `removeCoverageTerms` object, required

## Response `200`

OK

- SegmentResponse[]
  - `locator` string, ulid, required
  - `transactionLocator` string, ulid, required
  - `segmentType` 'coverage' | 'gap', required
  - `startTime` string, date-time, required
  - `endTime` string, date-time, required
  - `element` ElementResponse, required
    - `type` string, required
    - `locator` string, ulid, required
    - `parentLocator` string, ulid, required
    - `elements` ElementResponse[]
    - `coverageTerms` object
    - `data` object
    - `staticLocator` string, ulid, required
    - `originalEffectiveTime` string, date-time, required: Indicates when the element was first added to the policy
    - `category` 'product' | 'coverage' | 'exposure' | 'exposureGroup' | 'policyLine'
  - `duration` number, required
  - `basedOn` string, ulid
  - `anonymizedAt` string, date-time
  - `producerInfo` ProducerInfo
    - `producerCode` string
    - `producerCodeOfRecord` string
  - `proxyPayerLocator` string, ulid

---

[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)
