Replicate a Price Book

POST 
https://euwest.api.elasticpath.com/pcm/pricebooks/:pricebookID/replicate

Using this endpoint, you can replicate an existing price book. This is useful because it enables you to quickly and easily create multiple price books with the same pricing structure. When you replicate an existing price book, you can specify a new name, description, and external reference for the replicated price book. Other attributes stay the same.

Request

Path Parameters

pricebookID stringrequired

The unique identifier of a price book.

application/json

Body

A replicated price book with the following attributes.

data objectrequired
Price book replicate request.
typestringrequired
Possible values: [pricebook]
Default value: pricebook
Example: pricebook
attributes objectrequired
descriptionstringnullable
A brief description outlining the purpose of a price book, such as flash sale pricing or preferred customer pricing.
Example: This is a test price book
namestringnullable
The name of the price book. Price books must have a unique name.
Possible values: non-empty
Example: pricebook-store-abc
external_refstringnullable
A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.
Example: external-ref

Responses

201

A replicated price book with the following attributes.

application/json

Schema

Schema

data objectrequired
A price book with the following attributes.
idstringrequired
A unique identifier of a price book.
Example: 4c45e4ec-26e0-4043-86e4-c15b9cf985a7
typestringrequired
Always pricebook.
Possible values: [pricebook]
Default value: pricebook
Example: pricebook
attributes objectrequired
external_refstringnullable
A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.
Example: an-external-ref
descriptionstringnullable
A brief description that outlines the purpose of a price book, for example, flash sale pricing or preferred customer pricing.
Example: This is a test price book
namestringnullablerequired
The name of a price book. Price books must have a unique name
Example: Standard Price Book
created_atdate-timerequired
The date and time when the price book was created.
Example: 2020-09-22T09:00:00Z
updated_atdate-timerequired
The date and time when the price book was last updated.
Example: 2020-09-22T09:00:00Z
meta object
ownerstringnullable
The resource owner, either organization or store.
Example: store
links object
Links are used to allow you to move between requests.
selfurinullable
Single entities use a self parameter with a link to that specific resource.
Example: /pcm/pricebooks/4c45e4ec-26e0-4043-86e4-c15b9cf985a7

Example (auto)

{
  "data": {
    "id": "4c45e4ec-26e0-4043-86e4-c15b9cf985a7",
    "type": "pricebook",
    "attributes": {
      "external_ref": "an-external-ref",
      "description": "This is a test price book",
      "name": "Standard Price Book",
      "created_at": "2020-09-22T09:00:00Z",
      "updated_at": "2020-09-22T09:00:00Z"
    },
    "meta": {
      "owner": "store"
    }
  },
  "links": {
    "self": "/pcm/pricebooks/4c45e4ec-26e0-4043-86e4-c15b9cf985a7"
  }
}

default

Unexpected error.

application/json

Schema

Schema

errors object[]
Array [
detailstring
Example: The price book already exists
statusstring
Example: 409
titlestring
Example: conflict
]

Example (auto)

{
  "errors": [
    {
      "detail": "The price book already exists",
      "status": "409",
      "title": "conflict"
    }
  ]
}

Authorization: Authorization

name: Authorizationtype: httpin: headerscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://euwest.api.elasticpath.com/pcm/pricebooks/:pricebookID/replicate");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <Authorization>");
var content = new StringContent("{\n  \"data\": {\n    \"type\": \"pricebook\",\n    \"attributes\": {\n      \"description\": \"This is a test price book\",\n      \"name\": \"pricebook-store-abc\",\n      \"external_ref\": \"external-ref\"\n    }\n  }\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://euwest.api.elasticpath.com

Auth

Bearer Token

Parameters

pricebookID — pathrequired

Body

{
  "data": {
    "type": "pricebook",
    "attributes": {
      "description": "This is a test price book",
      "name": "pricebook-store-abc",
      "external_ref": "external-ref"
    }
  }
}

ResponseClear

Click the Send API Request button above and see the response here!