---
title: "Update Profile Mapping"
method: POST
path: "/api/v1/mappings/{mappingId}"
tags: ["ProfileMapping"]
---

# Update Profile Mapping

`POST /api/v1/mappings/{mappingId}`

## Request

- Base URL: `https://your-subdomain.okta.com`
- URL: `https://your-subdomain.okta.com/api/v1/mappings/{mappingId}`
- Auth: API key in header `Authorization`

Updates an existing Profile Mapping by adding, updating, or removing one or many Property Mappings.

## Path parameters

- `mappingId` string, required

## Request body

- ProfileMapping
  - `_links` object
  - `id` string
  - `properties` object
  - `source` ProfileMappingSource
    - `_links` object
    - `id` string
    - `name` string
    - `type` string
  - `target` ProfileMappingSource
    - `_links` object
    - `id` string
    - `name` string
    - `type` string

## Response `200`

Success

- ProfileMapping
  - `_links` object
  - `id` string
  - `properties` object
  - `source` ProfileMappingSource
    - `_links` object
    - `id` string
    - `name` string
    - `type` string
  - `target` ProfileMappingSource
    - `_links` object
    - `id` string
    - `name` string
    - `type` string

---

[API](https://skmtc.dev/okta/apis/okta-api.md) - [All operations](https://skmtc.dev/okta/apis/okta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/okta/apis/okta-api/revisions/7e5249c30571?raw)