---
title: "Update custom mapping"
method: PATCH
path: "/vault/custom-mappings/{unified_api}/{service_id}/{target_field_id}"
tags: ["Custom Mappings"]
---

# Update custom mapping

`PATCH /vault/custom-mappings/{unified_api}/{service_id}/{target_field_id}`

Update a custom mapping

## Path parameters

- `unified_api` string, required
- `service_id` string, required
- `target_field_id` string, required

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required

## Request body

- UpdateCustomMappingRequest
  - `value` string, required — Target Field Mapping value

## Response `200`

Custom mapping updated

- UpdateCustomMappingResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `data` CustomMapping, required
    - `id` string — Target Field ID
    - `label` string — Target Field name to use as a label
    - `description` string, nullable — Target Field description
    - `value` string — Target Field Mapping value
    - `key` string — Target Field Key
    - `required` boolean — Target Field Mapping is required
    - `custom_field` boolean — This mapping represents a finder for a custom field
    - `consumer_id` string, nullable — Consumer ID
    - `example` string, nullable — Target Field Mapping example value from downstream
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable
- `default` — Unexpected error

---

[API](https://skmtc.dev/apideck-libraries/apis/vault-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apideck-libraries/vault-api/revisions/fefba4c4b449/schema)