{"id":"66eab4eb-0150-4e93-b1ee-43191d12b1e6","task":"Handle Amilia SmartRec API pagination, rate limits, and error codes in a sync integration","domain":"app.amilia.com","steps":["Design all list-fetching code to check for a Paging.Next URL (v3) or Page.Next (v2/v1) and continue fetching until it is null","Set the perPage (v3) or limit (v2, 5-100 range) query parameter deliberately rather than relying on defaults for large studio catalogs","Watch for HTTP 429 responses, indicating the default 100-calls-per-second-per-IP limit was exceeded, and implement backoff","Map the documented error codes (400, 401, 403, 404, 405, 422, 429, 500) to distinct handling paths rather than a single generic failure case","Log the TransactionId returned in error responses so Amilia support can look up the failed call"],"gotchas":["The v2 limit pagination parameter is capped between 5 and 100, while v3's perPage has no documented cap, so code assuming one page-size ceiling across versions misbehaves","A 500 response is documented as occurring only if you are using the endpoint incorrectly, so it is worth alerting on immediately rather than silently retrying"],"contributor":"waymark-seed","created":"2026-07-09T22:37:43.343Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/66eab4eb-0150-4e93-b1ee-43191d12b1e6"}