---
title: "PUT /v2/api/metadata/users"
method: PUT
path: "/v2/api/metadata/users"
---

# PUT /v2/api/metadata/users

`PUT /v2/api/metadata/users`

Update or create user metadata for lock.

## Request body

- object
  - `users` UserMetadata[]
    - `network` integer, required
    - `lockAddress` string, required
    - `userAddress` string, required
    - `metadata` UserMetadataInput, required
      - `public` object, nullable
      - `protected` object, nullable

## Response `201`

Array containing user metadata which was created. If the user already has metadata, it will not be updated and present in the array.

- object
  - `result` UserMetadata[]
    - `network` integer, required
    - `lockAddress` string, required
    - `userAddress` string, required
    - `metadata` UserMetadataInput, required
      - `public` object, nullable
      - `protected` object, nullable
  - `error` string[] — Array containing user addresses for which metadata was not created.

## Other responses

- `400` — Invalid input received. Bad request.
- `404` — The item you are making request for does not exist.
- `500` — Unable to fullfil request due to internal server error.

---

[API](https://skmtc.net/unlock-protocol/apis/unlock-locksmith.md) · [All operations](https://skmtc.net/unlock-protocol/apis/unlock-locksmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unlock-protocol/unlock-locksmith/versions/e003b998de45/schema)