Reference
Tool reference
24 tools on the hosted server. Seller tools use psa_live_ keys. Partner tools require pk_live_.
Seller tools
| Tool | Scope | Class | Side effects |
|---|---|---|---|
printonic_list_stores | stores:read | Read | Read only |
printonic_search_catalog_products | catalog:read | Read | Read only |
printonic_get_catalog_product_detail | catalog:read | Read | Read only |
printonic_list_seller_products | products:read | Read | Read only |
printonic_create_listing_draft | listings:draft | Write | Counts against monthly quota |
printonic_list_orders | orders:read | Read | Read only |
printonic_get_order_detail | orders:read | Read | Read only |
printonic_attach_art_to_draft | listings:draft | Write | Writes seller data; does not charge |
printonic_update_seller_product | products:write | Write | Writes seller data; archived=true is destructive and held for approval |
printonic_create_order | orders:create | Money | Creates a pending order; held for seller approval by default |
printonic_generate_mockups | listings:draft | Write | Counts against monthly quota |
printonic_get_mockup_status | listings:draft | Read | Read only |
printonic_publish_listing | listings:publish | Publish | Publishes to Etsy; held for seller approval by default |
printonic_set_listing_pricing | products:write | Write | Writes seller data; does not charge |
printonic_set_listing_settings | products:write | Write | Writes seller data; does not charge |
printonic_check_publish_readiness | products:read | Read | Read only |
printonic_list_pending_actions | any key | Read | Read only: review-tray requests |
printonic_get_action_status | any key | Read | Read only: poll one held request |
Classes, the activity feed and the review tray
Every seller tool has a class: Read, Write (drafts, art, mockups, copy, Printonic-side prices), Publish, Money and Destructive. Every call, whatever its class, is recorded in the seller’s activity feed (Dashboard, Agent Access, Activity; also GET /api/seller/activity).
Publish, Money and Destructive calls are held for seller approval by default. A held call returns a normal (non-error) result with held_for_approval: true, a request_id, a preview of what would change and an expires_at (7 days). Poll printonic_get_action_status with the id (every 30 to 60 seconds) and do not resubmit the same action. Once the seller approves, the original call runs exactly once with the original arguments and its response appears under execution_result. Sellers can auto-approve a class in Agent Access, Settings; money can be auto-approved up to a per-order limit.
Partner tools
| Tool | Scope | Class | Side effects |
|---|---|---|---|
printonic_submit_paid_order | orders:pay | Money | Charges wallet or card |
printonic_create_custom_listing | listings:custom | Write | Writes partner data; does not charge |
printonic_list_gift_eligible_products | catalog:read | Read | Read only |
printonic_create_gift_set | listings:custom | Write | Writes partner data; does not charge |
printonic_get_billing_balance | billing:read | Read | Read only |
printonic_settle_balance | orders:pay | Money | Charges wallet or card |