---
id: provider-replace
title: "Replace a provider"
description: "Replace a provider by ID"
sidebar_label: "Replace a provider"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "put api-method"
info_path: docs/api/providers
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Replace a provider"}
>
</Heading>

<MethodEndpoint
  method={"put"}
  path={"/provider/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Replace a provider by ID

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"schema":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"in":"path","name":"id","required":true}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"title":"ProviderUpdate","description":"Object to update a provider","properties":{"attributes":{"type":"object","description":"Provider-specific attributes defined in the specification schema"},"tags":{"type":"array","description":"Tags associated with the provider","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"}},"required":["key","value"],"additionalProperties":false}}},"example":{"attributes":{"cluster":{"id":"my-np-gcp-prod","location":"s-west1","namespace":"my-namespace"},"gateway":{"public_name":"my-public-gateway","private_name":"my-private-gateway"}},"tags":[{"key":"cluster.id","value":"my-np-gcp-prod"}]}}}},"description":"Object to update a provider"}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing a provider resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"nrn":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"attributes":{"type":"object","description":"Provider-specific attributes defined in the specification schema"},"dimensions":{"type":"object","description":"NRN-specific dimensions. [Read more](/docs/dimensions)"},"tags":{"type":"array","description":"Tags associated with the provider","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"},"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"}},"required":["key","value","id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"string"},"description":"Groups associated with the provider"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"}},"title":"ProviderRead","description":"Object representing a provider resource","example":{"id":"a3f1c2d4-e5b6-7890-ab12-cdef34567890","nrn":"organization=1:account=1:namespace=1","dimensions":{"environment":"production"},"specification_id":"02fd22f1-6bf9-41aa-9b58-29d50f725855","attributes":{"cluster":{"id":"my-np-gcp-prod","location":"s-west1","namespace":"my-namespace"},"gateway":{"public_name":"my-public-gateway","private_name":"my-private-gateway"}},"tags":[{"id":"4e2306de-82e3-4b74-a419-e0e324beb500","key":"cluster.id","value":"my-np-gcp-prod"}],"created_at":"2024-10-15T08:30:00Z","updated_at":"2024-10-20T14:45:00Z"},"required":["id","nrn","specification_id","attributes","created_at","updated_at"]}}}},"4XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}},"5XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}}}}
>
  
</StatusCodes>