Skip to main content
POST
/
api
/
v1
/
:team_slug
/
:app_slug
/
schedule
Error
A valid request URL is required to generate request examples
{
  "data": {
    "execute_at": "<string>",
    "finished_at": "<string>",
    "id": "<string>",
    "item_id": "<string>",
    "item_type": "<string>",
    "to_amount_cents_with_tax": 123,
    "to_on_sale": true,
    "to_sale_amount_cents_with_tax": 123,
    "to_status": "<string>"
  },
  "details": [
    "<string>"
  ],
  "success": true
}

Path Parameters

​
app_slug
string
required

App slug

​
team_slug
string
required

Team slug

Body

application/json

Scheduling data

​
execute_at
string
required

Execute at is the date when the product should change date. This date need to follow the format YYYY-MM-DD

​
item_id
string
required
​
item_type
enum<string>
required
Available options:
product,
tag,
image,
price,
variant
​
to_on_sale
boolean

Used to change if a price is on sale on a specific date. Only used when item_type is price

​
to_price_with_tax
integer

Used to change the price on a specific date. Only used when item_type is price

​
to_sale_price_with_tax
integer

Used to change the sale price on a specific date. Only used when item_type is price

​
to_status
enum<string>
Available options:
active,
inactive,
archived,
draft

Response

Job is scheduled

​
data
object
​
details
string[]

Other information which can be relative to the response. This field is used to give additional information then the main data we want to return. For instance if a product do not match the publishing rules will the product status be set to Incomplete and this field will include why

​
success
boolean