UpdateSubmission is used to move a submission to another status this can be done when its actually submitted for ingestion and/or when the ingestion is complete.

PUT

/v2/storefront/listing/submission/{type}/{sku}

curl --request PUT \
  --url https://api.zentail.com/v2/storefront/listing/submission/example/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "contentReceived": "example", "metadata": { "additionalProperty": "example" }, "changedAt": "2026-04-15T12:00:00Z", "status": "STATUS_UNSPECIFIED" }'

Authorizations

• zentail_oauth

Parameters

Path Parameters

type

required

string

The submission type used when creating the submission

sku

required

string

Request Body^required

Media typeapplication/json

UpdateSubmissionRequest is used to move a submission to another status

object

contentReceived

string

metadata

object

key

additional properties

string

changedAt

string format: date-time

status

string

default: STATUS_UNSPECIFIED

Allowed values: STATUS_UNSPECIFIED STATUS_SUBMITTED STATUS_ACCEPTED STATUS_REJECTED

Responses

200

A successful response.

Media typeapplication/json

Submission represents specific data sent to a channel for a particular SKU

object

submissionId

submission_id is returned by the API, setting this when calling ReplaceSubmissions will have no effect

string format: int64

sku

string

contentSent

string

contentReceived

string

metadata

object

key

additional properties

string

type

type is a user-specified type which is used to match like submissions when doing a replace operation

string

successful

boolean

submittedAttributeVersionIds

submitted_attribute_version_ids are the Attribute Version IDs of all of the Attributes that were part of this Submission. This is used to show the user in Zentail when each of the Attributes in the Listing were submitted. This is also reflected in the Listing and Variant endpoints via the submitted_at timestamp on each Attribute

Array<string>

preparedAt

string format: date-time

submittedAt

string format: date-time

acknowledgedAt

string format: date-time

Example^generated

{
  "submissionId": "example",
  "sku": "example",
  "contentSent": "example",
  "contentReceived": "example",
  "metadata": {
    "additionalProperty": "example"
  },
  "type": "example",
  "successful": true,
  "submittedAttributeVersionIds": [
    "example"
  ],
  "preparedAt": "2026-04-15T12:00:00Z",
  "submittedAt": "2026-04-15T12:00:00Z",
  "acknowledgedAt": "2026-04-15T12:00:00Z"
}

default

An unexpected error response.

Media typeapplication/json

object

code

integer format: int32

message

string

details

Array<object>

object

@type

string

key

additional properties

Example^generated

{
  "code": 1,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}