generated: '2026-08-13'
method: generated
source: openapi/famous-spring-api-swagger.json + https://api.teespring.com/docs
api: Spring Seller API
base_url: https://api.teespring.com/
note: >-
  Amaze/Spring publishes no AGENTS.md, no skills directory and no agent-facing documentation of any
  kind — https://api.teespring.com/docs is a Swagger UI page with four authentication steps. These
  four skills are GENERATED by API Evangelist and every operationId in them was grepped out of the
  published Swagger 2.0 document; none is invented. Response field names are deliberately absent,
  because the spec declares no response schemas and we did not make an authenticated call.
skills:
- name: famous-authenticate-spring-seller
  file: famous-authenticate-spring-seller.md
  description: Mint and use a 24-hour Spring Seller API access token, and handle its expiry.
  operations: [postV1AuthTokens, getV1UsersMe]
  consequence: read
- name: famous-reconcile-seller-orders
  file: famous-reconcile-seller-orders.md
  description: Pull a seller's orders for a date range and state, page through them, and tie each
    order back to its campaign and payout.
  operations:
  - postV1AuthTokens
  - getSellerV1Orders
  - getSellerV1OrdersForBuyerFromOrderLookupNumber
  - getSellerV1Campaigns
  - getSellerV1Payouts
  consequence: read
- name: famous-campaign-performance-review
  file: famous-campaign-performance-review.md
  description: Build a seller performance review from the dashboard, period summary, campaign
    rankings, promotions and volume-discount tier.
  operations:
  - postV1AuthTokens
  - getSellerV1Dashboard
  - getSellerV1Summary
  - getSellerV1Campaigns
  - getSellerV1CampaignsSlug
  - getSellerV1Promotions
  - getSellerV1DashboardVolumeDiscount
  consequence: read
- name: famous-message-buyers
  file: famous-message-buyers.md
  description: Send a templated message to a seller's buyers, previewing recipients first.
  operations:
  - postV1AuthTokens
  - getSellerV1MessagesVariables
  - getSellerV1MessagesRecipients
  - postSellerV1MessagesSend
  consequence: physical
  human_in_the_loop: required
  warning: >-
    Delivers real email to real customers with no idempotency key. A retry after a timeout can
    double-send.
not_covered:
  reason: >-
    The remaining published operations are either public storefront reads that need only an app_id
    (getV1CampaignsSlug, getV1CategoriesSlug, getV1CategoriesSlugCampaigns,
    getV1RecommendersRecommenderIdCampaigns, getV1RushPricesCampaignRegionName,
    getV1SearchSuggestionsTrending), user-profile reads (getV1UsersMeSavedAddresses,
    getV1UsersMeSavedCards), or inbound Stripe webhook receivers that no developer calls
    (postInternalV1StripeDisputeCreated, postInternalV1StripeDisputeClosed).