Salesforce B2C Commerce 24.7 > Open Commerce API 23.2 > Data API resources 23.2

CodeVersions resource (Data API 23.2)

Summary

Http Method	Resource	Description
GET	/code_versions	Read all existing code versions.
PUT	/code_versions/{code_version_id}	Create a new code version.
PATCH	/code_versions/{code_version_id}	Update an existing code version. Only an inactive code version can be updated. Only the active flag and the id can be changed. The active flag can therefore only set to "true". To set the active flag to "false" will not work.
GET	/code_versions/{code_version_id}	Read a code version.
DELETE	/code_versions/{code_version_id}	Delete a code version.

Get all code versions

Read all existing code versions.

Url

GET https://hostname:port/dw/data/v23_2/code_versions

Formats

json, xml

Authentication

Name	Description
OAuth	Authentication via OAuth token.

Response Document

CodeVersionResult

Sample

REQUEST:
GET /s/-/dw/data/v23_2/code_versions HTTP/1.1
Host: example.com
Authorization: Bearer a5b6eb0d-8312-41a3-88f3-2c53c4507367
Content-Type: application/json; charset=UTF-8

RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "_type" : "code_version_result",
   "count" : 1,
   "data" : 
   [
      {
         "_type" : "code_version",
         "_resource_state" : "860cde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73bd5",
         "activation_time" : "2016-01-14T16:48:07Z",
         "active" : true,
         "cartridges" : "bc_gillian, test_bc_wapi, test_bc_wapi_deprecated",
         "compatibility_mode" : "16.2",
         "id" : "version1",
         "last_modification_time" : "2016-01-14T16:48:07Z",
         "rollback" : false,
         "total_size" : "537 KB",
         "web_dav_url" : "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version1"
      }
   ],
   "total" : 1
}

Create code version

Create a new code version.

Url

PUT https://hostname:port/dw/data/v23_2/code_versions/{code_version_id}

Formats

json, xml

Authentication

Name	Description
OAuth	Authentication via OAuth token.

Response Document

CodeVersion

Path Parameters

Parameter	Type	Description	Constraints
code_version_id	String	The id of the code version.	minLength=1

In case of a failure Fault Document is returned.

Faults

Status	Type	Arguments	Description
409	`CodeVersionIdAlreadyExistsException`	codeVersionId (String)	Indicates that a code version with the given id already exists.

Sample

REQUEST:
PUT /s/-/dw/data/v23_2/code_versions/version2 HTTP/1.1
Host: example.com
Authorization: Bearer a5b6eb0d-8312-41a3-88f3-2c53c4507367
Content-Type: application/json; charset=UTF-8
Content-Length: 0

# in case of success:

RESPONSE:
HTTP/1.1 201 CREATED
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Location: https://example.com/s/-/dw/data/v23_2/code_versions/version2
{
   "_v" : "23.2",
   "_resource_state" : "860cde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73bd5",
   "_type" : "code_version",
   "active" : false,
   "compatibility_mode" : "16.2",
   "creation_time" : "2016-01-15T10:52:50Z",
   "id" : "version2",
   "last_modification_time" : "2016-01-15T10:52:50Z",
   "rollback" : false,
   "web_dav_url" : "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version2"
}

# in case of failure:

HTTP/1.1 409 CONFLICT
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionIdAlreadyExistsException",
      "message" : "The code version ID 'version2' already exists."
   }
}

Update a code version

Update an existing code version.

Only an inactive code version can be updated.
Only the active flag and the id can be changed. The active flag can therefore only set to "true".
To set the active flag to "false" will not work.

Url

PATCH https://hostname:port/dw/data/v23_2/code_versions/{code_version_id}

Formats

json, xml

Authentication

Name	Description
OAuth	Authentication via OAuth token.

Request Document

CodeVersion

Response Document

CodeVersion

Path Parameters

Parameter	Type	Description	Constraints
code_version_id	String	The id of the code version.	minLength=1

In case of a failure Fault Document is returned.

Faults

Status	Type	Arguments	Description
400	`CodeVersionModificationException`	codeVersionId (String)	Indicates that a code version with the given id can't be updated (because it is active).
404	`CodeVersionIdNotFoundException`	codeVersionId (String)	Indicates that a code version with the given id was not found.
409	`CodeVersionIdAlreadyExistsException`	codeVersionId (String)	Indicates that a code version with the given id already exists.

Sample

## Example 1:
REQUEST:
PATCH /s/-/dw/data/v23_2/code_versions/version2 HTTP/1.1
Host: example.com
{
   "_resource_state" : "t9ccde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73b8h6"
   "active": true
}
 
# in case of success:
 
RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "_resource_state" : "860cde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73bd5",
   "_type" : "code_version",
   "activation_time" : "2016-01-15T11:19:31Z",
   "active" : true,
   "compatibility_mode" : "16.2",
   "creation_time" : "2016-01-15T11:19:31Z",
   "id" : "version2",
   "last_modification_time" : "2016-01-15T11:19:31Z",
   "rollback" : false,
   "web_dav_url" : "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version2"
}

# in case of failure:
 
RESPONSE:
HTTP/1.1 404 NOT FOUND
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionIdNotFoundException",
      "message" : "The code version with ID 'version2' could not be found."
   }
}

## Example 2:

REQUEST:
PATCH /s/-/dw/data/v23_2/code_versions/version2 HTTP/1.1
Host: example.com
{
   "_resource_state" : "t9ccde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73b8h6"
   "id": "version3"
}

# in case of success:
 
RESPONSE:
HTTP/1.1 301 MOVED PERMANENTLY
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
Location: https://example.com/s/-/dw/data/v23_2/code_versions/version3
{
   "_v" : "23.2",
   "_resource_state" : "860cde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73bd5",
   "_type" : "code_version",
   "activation_time" : "2016-01-15T11:19:31Z",
   "active" : false,
   "compatibility_mode" : "16.2",
   "creation_time" : "2016-01-15T11:19:31Z",
   "id" : "version3",
   "last_modification_time" : "2016-01-15T11:19:31Z",
   "rollback" : false,
   "web_dav_url" : "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version2"
}

# in case of failure:
 
RESPONSE:
HTTP/1.1 404 NOT FOUND
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionIdNotFoundException",
      "message" : "The code version with ID 'version2' could not be found."
   }
}

HTTP/1.1 400 BAD REQUEST
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionModificationException",
      "message" : "The code version 'version2' is active and cannot be changed."
   }
}

HTTP/1.1 409 CONFLICT
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version3"
      },
      "type" : "CodeVersionIdAlreadyExistsException",
      "message" : "The code version ID 'version3' already exists."
   }
}

Get a code version

Read a code version.

Url

GET https://hostname:port/dw/data/v23_2/code_versions/{code_version_id}?expand={String}

Formats

json, xml

Authentication

Name	Description
OAuth	Authentication via OAuth token.

Response Document

CodeVersion

Path Parameters

Parameter	Type	Description	Constraints
code_version_id	String	The id of the code version.	minLength=1

Query Parameters

Parameter	Type	Description	Constraints
expand	String	The expand parameter. Allowed value (size).

In case of a failure Fault Document is returned.

Faults

Status	Type	Arguments	Description
404	`CodeVersionIdNotFoundException`	codeVersionId (String)	Indicates that a code version with the given id was not found.

Sample

REQUEST:
GET /s/-/dw/data/v23_2/code_versions/version2 HTTP/1.1
Host: example.com
Authorization: Bearer a5b6eb0d-8312-41a3-88f3-2c53c4507367
Content-Type: application/json; charset=UTF-8

# in case of success:

RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "_resource_state" : "860cde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73bd5",
   "_type" : "code_version",
   "activation_time" : "2016-01-14T16:48:07Z",
   "active" : true,
   "cartridges" : [ "storefront", "storefront_richUI", "sitegenesis", "sitegenesis_richUI" ],
   "compatibility_mode" : "16.2",
   "id" : "version2",
   "last_modification_time" : "2016-01-14T16:48:07Z",
   "rollback" : false,
   "total_size" : 537345,
   "web_dav_url" : "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version2"
}

# in case of failure:

RESPONSE:
HTTP/1.1 404 NOT FOUND
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionIdNotFoundException",
      "message" : "The code version with ID 'version2' could not be found."
   }
}

Delete a code version

Delete a code version.

Url

DELETE https://hostname:port/dw/data/v23_2/code_versions/{code_version_id}

Formats

json, xml

Authentication

Name	Description
OAuth	Authentication via OAuth token.

Path Parameters

Parameter	Type	Description	Constraints
code_version_id	String	The id of the code version.	minLength=1

In case of a failure Fault Document is returned.

Faults

Status	Type	Arguments	Description
400	`CodeVersionModificationException`	codeVersionId (String)	Indicates that a code version with the given id can't be deleted (because it is active).
404	`CodeVersionIdNotFoundException`	codeVersionId (String)	Indicates that a code version with the given id was not found.

Sample

REQUEST:
DELETE /s/-/data/v23_2/code_versions/version2 HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
x-dw-resource-state: 860cde3040519cce439cd99e209f8a87c3ad0b7e2813edbf6f5501f763b73bd5

# in case of success:

RESPONSE:
HTTP/1.1 204 NO CONTENT

# in case of failure:

RESPONSE:
HTTP/1.1 404 NOT FOUND
Content-Type: application/json; charset=UTF-8
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionIdNotFoundException",
      "message" : "The code version with ID 'version2' could not be found."
   }
}

HTTP/1.1 400 BAD REQUEST
{
   "_v" : "23.2",
   "fault" : 
   {
      "arguments" : 
      {
         "codeVersionId" : "version2"
      },
      "type" : "CodeVersionModificationException",
      "message" : "The code version 'version2' is active and cannot be changed."
   }
}

X OCAPI versions 15.x and 16.x will be retired on March 31, 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.