---
title: "Update shared components with users"
method: PUT
path: "/{globalCompanyId}/componentmetadata/shares"
tags: ["Component Meta Data"]
---

# Update shared components with users

`PUT /{globalCompanyId}/componentmetadata/shares`

Warning: Deletes and overwrites all pre-existing shares for given components. Create one/many shares for one/many components at once. For each component object in the passed list, the given shares will replace the current set of shares for each component. For example, if one of the components was previously shared with additional users, and that share is not passed in here, it will no longer be shared with them.<br>

## Path parameters

- `globalCompanyId` string, required

## Query parameters

- `locale` string
- `useCache` boolean

## Headers

- `Authorization` string, required
- `x-api-key` string, required

## Request body

- SharedComponent[]
  - `componentType` string
  - `componentId` string
  - `shares` SharedToEntity[]
    - `shareToId` integer
    - `shareToImsId` string
    - `shareToType` string
    - `accessLevel` string

## Response `200`

successful operation

- SharedComponent
  - `componentType` string
  - `componentId` string
  - `shares` SharedToEntity[]
    - `shareToId` integer
    - `shareToImsId` string
    - `shareToType` string
    - `accessLevel` string

## Other responses

- `400` — Invalid component type, or mixed component types on request (only one type per request)
- `403` — Permission error; user does not have access for the requested operation
- `500` — Unable to save list of component shares

## Changes

- **2025-08-07** `f13c80692287` — 1 warning
  - deleted the `header` request parameter `x-gw-ims-org-id`
- **2025-08-06** `f49e893a6c2b` — 1 breaking
  - added the new required `header` request parameter `x-gw-ims-org-id`
- **2022-05-10** `dcd4514630c4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/adobe/apis/adobe-analytics-apis/changes/:globalCompanyId/componentmetadata/shares/put.md)

---

[API](https://skmtc.dev/adobe/apis/adobe-analytics-apis.md) · [All operations](https://skmtc.dev/adobe/apis/adobe-analytics-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adobe/adobe-analytics-apis/revisions/b2e01ce0f30a/schema)