Skip to content
Bottle

List what is in the bin

GET
/storefront/bin
curl --request GET \
  --url 'https://example.com/storefront/bin?kind=page' \
  --cookie __Host-bottle.session_token=<__Host-bottle.session_token>

Shop pages, blog posts and menus deleted in the last 90 days, most recently deleted first, with who deleted each, when, and when it goes for good; with kind, one kind only. The daily job removes each 90 days after it was deleted. The lists of pages and posts show theirs too, with status=bin.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
kind
string
Allowed values: page post menu

Responses

Section titled “Responses”

200

Section titled “200”

What is in the bin

Media typeapplication/json
object
items
required
Array<object>
object
id
required

The bin entry, for restoring or deleting for good.

string format: uuid
kind
required
string
Allowed values: page post menu
itemId
required
string
name
required

Its title or name when it was deleted.

string
deletedAt
required
string format: date-time
deletedBy
required
object
kind
required

Person: someone signed in. key: an API key. assistant: an app connected over MCP. support: Bottle staff in a support session the business allowed.

string
Allowed values: person key assistant support
name
required

The person’s name then, or the key’s or the app’s.

string
goneAt
required

When it is removed for good.

string format: date-time
wasPublished
required

A page or post that was on the shop when it was deleted. It comes back as a draft: publish it again to put it back.

boolean
daysLeft
required
integer

Example 

{
  "items": [
    {
      "kind": "page",
      "deletedBy": {
        "kind": "person"
      }
    }
  ]
}

401

Section titled “401”

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}

402

Section titled “402”

The plan does not include a shop

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}

403

Section titled “403”

Not a member, or without the permission this needs

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}