---
title: "Update a provider or create a new one if it does not exist."
method: PUT
path: "/providers/{id}"
tags: ["Atramhasis"]
---

# Update a provider or create a new one if it does not exist.

`PUT /providers/{id}`

Update a provider or create a new one if it does not exist.

## Request body

- object
  - `id` string, nullable, required
  - `type` string, nullable
  - `conceptscheme_uri` string, required
  - `uri_pattern` string, nullable, required
  - `default_language` string, nullable
  - `subject` string[], nullable
  - `force_display_language` string, nullable
  - `id_generation_strategy` 'NUMERIC' | 'GUID' | 'MANUAL', nullable
  - `expand_strategy` 'recurse' | 'visit', nullable
  - `metadata` object, nullable

## Response `200`

Provider updated successfully

- Provider
  - `id` string, nullable
  - `type` string, nullable
  - `conceptscheme_uri` string, required
  - `uri_pattern` string, nullable, required
  - `default_language` string, nullable
  - `subject` string[], nullable
  - `force_display_language` string, nullable
  - `id_generation_strategy` 'NUMERIC' | 'GUID' | 'MANUAL', nullable
  - `expand_strategy` 'recurse' | 'visit', nullable
  - `metadata` object, nullable

## Other responses

- `201` — Provider created successfully
- `4XX` — Bad request.
- `5XX` — Unexpected error.

## Changes

- **2025-11-20** `d98571488187` — 3 info
  - removed the pattern `.*%s.*` from the request property `allOf[#/components/schemas/Provider]/uri_pattern`
  - the `uri_pattern` response's property pattern `.*%s.*` was removed for the status `200`
  - the `uri_pattern` response's property pattern `.*%s.*` was removed for the status `201`
- **2023-05-22** `79ffbe0b7d48` — 1 info
  - added the success response with the status `201`
- **2023-05-02** `85ea419fdbd1` — 1 info
  - endpoint added
- **2021-12-20** `720170256c20` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/onroerenderfgoed/apis/atramhasis-api/changes/providers/:id/put.md)

---

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