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

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

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

## Request

- Base URL: `https://docs.socotra.com`
- URL: `https://docs.socotra.com/policy/{tenantLocator}/transactions/{locator}/underwritingFlags`
- Auth: none declared
- TypeScript: <https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/docs/policy/:tenantLocator/transactions/:locator/underwritingFlags/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

- UnderwritingFlagsUpdateRequest
  - `addFlags` UnderwritingFlagCreateRequest[], required
    - `level` 'info' | 'block' | 'decline' | 'reject' | 'approve', required
    - `note` string, required
    - `tag` string, required
    - `elementLocator` string, ulid, required
    - `taskCreation` UnderwritingTaskCreateRequest, required
      - `type` string, required
      - `references` TaskReference[], required
        - `referenceType` 'account' | 'quickQuote' | 'quote' | 'policy' | 'transaction' | 'invoice' | 'underwritingFlag' | 'payment' | 'quoteGroup' | 'inquiry', required
        - `referenceLocator` string, ulid, required
      - `underwritingFlagLocators` string[], required
      - `deadlineTime` string, date-time
      - `assignedTo` string, uuid
      - `description` string
      - `workgroupToBeAssignedLocator` string, ulid
      - `source` string
      - `tag` string
      - `labels` string[], required
  - `clearFlags` string[], required

## Response `200`

OK

- TransactionUnderwritingFlagsResponse
  - `transactionLocator` string, ulid, required
  - `flags` UnderwritingFlagResponse[], required
    - `locator` string, ulid, required
    - `level` 'info' | 'block' | 'decline' | 'reject' | 'approve', required
    - `referenceType` 'quote' | 'transaction', required
    - `referenceLocator` string, ulid, required
    - `note` string, required
    - `tag` string, required
    - `elementLocator` string, ulid
    - `createdBy` string, uuid, required
    - `createdTime` string, date-time, required
    - `clearedBy` string, uuid, required
    - `clearedTime` string, date-time, required
    - `taskCreationResponse` TaskCreationResponse, required
      - `taskLocator` string, ulid, required
      - `status` 'succeeded' | 'failed', required
  - `clearedFlags` UnderwritingFlagResponse[], required
    - `locator` string, ulid, required
    - `level` 'info' | 'block' | 'decline' | 'reject' | 'approve', required
    - `referenceType` 'quote' | 'transaction', required
    - `referenceLocator` string, ulid, required
    - `note` string, required
    - `tag` string, required
    - `elementLocator` string, ulid
    - `createdBy` string, uuid, required
    - `createdTime` string, date-time, required
    - `clearedBy` string, uuid, required
    - `clearedTime` string, date-time, required
    - `taskCreationResponse` TaskCreationResponse, required
      - `taskLocator` string, ulid, required
      - `status` 'succeeded' | 'failed', 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)