---
title: "Retire Provider Contract. When 'Trade' and 'StoreId' are not specified then provider is 'retired' from all subscriber's stores."
method: PUT
path: "/contracts/retire"
tags: ["Contracts"]
---

# Retire Provider Contract. When 'Trade' and 'StoreId' are not specified then provider is 'retired' from all subscriber's stores.

`PUT /contracts/retire`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/contracts/retire`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/contracts/retire/put.ts> (a function with typed inputs; its response is checked against the schema)

Available only for Subscriber Super Admin user.

## Request body

- ServiceChannelServicesMessagingLocationRetireProviderRequest
  - `StoreId` string: Optional, When 'Trade' and 'StoreId' are not specified then provider is 'retired' from all subscriber's stores.
  - `Trade` string: Optional, When 'Trade' and 'StoreId' are not specified then provider is 'retired' from all subscriber's stores.
  - `ProviderId` integer, required: Required Provider Id

## Response `200`

Indicates that the request succeeded. When 'Trade' and 'StoreId' are not specified then provider is 'retired' from all subscriber's stores.

- SystemObject

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)