shops.export

Owner only: everything the shop holds as one ZIP: data/<table>.csv and data/<table>.json for every shop table, files/ with job photos (and the original HEIC or TIFF file next to its JPEG copy) and PDFs, and manifest.json. Signing secrets and token hashes are left out. By default you get download_url, a link that works for 60 minutes and up to 5 downloads; anyone with the link can download, so do not share it. delivery "inline" returns zip_base64 instead, only for exports up to 10 MB. Large shops: pass include_files false for data only.

WhoAgents can call this
RESTPOST /v1/shops/export
MCP toolshops_export
Writesno
AreaShop

When to use it

Owner only: everything the shop holds as one ZIP: data/<table>.csv and data/<table>.json for every shop table, files/ with job photos (and the original HEIC or TIFF file next to its JPEG copy) and PDFs, and manifest.json. Signing secrets and token hashes are left out.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
shop_idstring (uuid)yes
include_filesbooleanno
deliverystring (one of link, inline)no
link_minutesintegerno

Example

POST https://doingwork.work/v1/shops/export
content-type: application/json
Idempotency-Key: 3f1c...

{
  "shop_id": "00000000-0000-4000-8000-000000000000"
}

Output

FieldTypeAlways there
filenamestringyes
content_typestringyes
bytesintegeryes
sha256stringyes
deliverystringyes
download_urlstringno
expires_atstring (date-time)no
max_downloadsintegerno
export_idstring (uuid)no
zip_base64stringno
tablesobjectyes
skipped_tablesarrayyes
filesintegeryes
{
  "filename": "...",
  "content_type": "...",
  "bytes": 1,
  "sha256": "...",
  "delivery": "...",
  "tables": {},
  "skipped_tables": [
    "..."
  ],
  "files": 1
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.