---
title: "PUT /listings/{id}"
method: PUT
path: "/listings/{id}"
tags: ["Listings"]
---

# PUT /listings/{id}

`PUT /listings/{id}`

## Path parameters

- `id` string, required

## Request body

- DpListing
  - `id` string
  - `status` string
  - `contract` DpContractNameAndMarketplaceReference
    - `id` string
    - `type` string
    - `name` string
  - `product` DpProduct — Product References representation.
    - `id` string, required
    - `icon` string, binary
    - `name` string
    - `status` string
    - `category` DpCategoryReference
      - `id` string
      - `name` string, required
    - `description` string
  - `created` string, date-time
  - `updated` string, date-time
  - `vendor` DpAccountReference
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `provider` DpAccountReference
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `pending_request` DpListingRequestReference
    - `id` string
    - `type` 'new' | 'remove', required
    - `status` string, required
  - `offer` DpOffer, required
    - `id` string, nullable, required
    - `name` string
    - `plans` DpId[]
      - `id` string, required
    - `type` 'generic' | 'commerce', nullable
  - `pricelist` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_1` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_2` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required

## Response `200`

- DpListing
  - `id` string
  - `status` string
  - `contract` DpContractNameAndMarketplaceReference
    - `id` string
    - `type` string
    - `name` string
  - `product` DpProduct — Product References representation.
    - `id` string, required
    - `icon` string, binary
    - `name` string
    - `status` string
    - `category` DpCategoryReference
      - `id` string
      - `name` string, required
    - `description` string
  - `created` string, date-time
  - `updated` string, date-time
  - `vendor` DpAccountReference
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `provider` DpAccountReference
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `pending_request` DpListingRequestReference
    - `id` string
    - `type` 'new' | 'remove', required
    - `status` string, required
  - `offer` DpOffer, required
    - `id` string, nullable, required
    - `name` string
    - `plans` DpId[]
      - `id` string, required
    - `type` 'generic' | 'commerce', nullable
  - `pricelist` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_1` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_2` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/versions/54fef191d46c/schema)