Skip to content

audit: Spec Drift [2026-04-06] — medium #20

@github-actions

Description

@github-actions

Etsy API Drift — medium severity

Detected: 2026-04-06 | Severity: medium | Summary: changed endpoints, schema changes, 8 code issues

What Changed (Diff Report)

Etsy OAS Spec Diff Report

New Endpoints

No new endpoints.

Removed Endpoints

No removed endpoints.

Changed Endpoints

findAllListingsActive (GET /v3/application/listings/active)

  • Parameters added: buyer_country, currency

getListingsByListingIds (GET /v3/application/listings/batch)

  • Parameters added: buyer_country, currency

Schema Changes

New Schemas

  • ListingBuyerPrice: base_price, shipping_cost, original_price, discounted_price, discount_amount, discount_percentage, has_discount, discount_start_epoch, discount_end_epoch

ShopListing

  • Properties added: converted_price

ShopListingWithAssociations

  • Properties added: buyer_price, converted_price

Deprecations

No new deprecations.

SDK Impact (Audit Report)

Coverage Summary

  • Total OAS operations: 103
  • Mapped to SDK methods: 103 (103 implemented, 0 stubs)
  • Missing from SDK: 0
  • Extra SDK methods (no OAS match): 4
  • Code issues found: 8
  • Missing exports: 0
  • Effective coverage: 100.0%

Missing Endpoints

Code Issues (8)

Code Issues

Potential bugs detected by static analysis.

Implicit String Concatenation

Adjacent string literals without a comma — these silently concatenate into a single string.

  • Listing.py:113: "personalization_is_required, personalization_char_count_max, and " "personalization_instructions are deprecated and will be removed "
  • Listing.py:114: "personalization_instructions are deprecated and will be removed " "from the Etsy API on April 9, 2026. Use the personalization "
  • Listing.py:115: "from the Etsy API on April 9, 2026. Use the personalization " "endpoint (update_listing_personalization) instead."
  • Listing.py:214: "personalization_is_required, personalization_char_count_max, and " "personalization_instructions are deprecated and will be removed "
  • Listing.py:215: "personalization_instructions are deprecated and will be removed " "from the Etsy API on April 9, 2026. Use the personalization "
  • Listing.py:216: "from the Etsy API on April 9, 2026. Use the personalization " "endpoint (update_listing_personalization) instead."
  • Payment.py:28: "get_shop_payment_account_ledger_entry_payments is deprecated, " "use get_payment_account_ledger_entry_payments"
  • ShippingProfile.py:94: "get_shop_shipping_profile_destination_by_shipping_profile is deprecated, " "use get_shop_shipping_profile_destinations_by_shipping_profile"
Extra SDK Methods (no OAS match)

Extra SDK Methods

SDK methods with no matching OAS operation (possibly removed or renamed).

  • get_listings_by_listings_ids in Listing.py:149 (ListingResource)
  • get_shop_payment_account_ledger_entry_payments in Payment.py:23 (PaymentResource)
  • get_shop_receipt_transaction_by_shop in ReceiptTransactions.py:44 (ReceiptTransactionsResource)
  • get_shop_shipping_profile_destination_by_shipping_profile in ShippingProfile.py:89 (ShippingProfileResource)

Missing Exports


Action Required

Review recommended. New or changed endpoints that may need SDK updates.

  1. Run /maintain-audit to review changes
  2. Check if new endpoints need SDK methods

Auto-generated by Maintenance Check

Metadata

Metadata

Assignees

Labels

api-driftAuto-created when Etsy API spec changes are detected by weekly maintenance checkseverity: mediumMedium severity — new/changed endpoints need review

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions