Skip to content
Bottle

List recent imports

GET
/imports
curl --request GET \
  --url https://example.com/imports \
  --cookie __Host-bottle.session_token=<__Host-bottle.session_token>

The last 20 imports, newest first, with what each added and changed, and the column matching remembered from the last import of each kind.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

The imports

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

UUID v7

string format: uuid
kind
required
string
Allowed values: customers cylinders
fileName
required
string
created
required
integer
updated
required
integer
skipped
required
integer
byName
required
string | null
createdAt
required
string format: date-time
undoneAt
required
string | null format: date-time
mappings
required
object
customers
required
object
key
additional properties
string
cylinders
required
object
key
additional properties
string

Example 

{
  "items": [
    {
      "id": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f",
      "kind": "customers"
    }
  ]
}

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"
}

403

Section titled “403”

Not an owner or admin, or the plan does not open Assets

Media typeapplication/json
object
error
required
string
message
required
string

Example 

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

404

Section titled “404”

Not found, or Assets is not available to this business

Media typeapplication/json
object
error
required
string
message
required
string

Example 

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

409

Section titled “409”

Assets is switched off, or the import was already undone

Media typeapplication/json
object
error
required
string
message
required
string

Example 

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

422

Section titled “422”

Validation failed, or rows still have problems

Media typeapplication/json
object
error
required
string
Allowed values: validation
message
required
string
issues
required
Array<object>
object
path
required
string
message
required
string

Example 

{
  "error": "validation",
  "issues": [
    {
      "path": "email",
      "message": "Invalid email"
    }
  ]
}