{"id":"38f87fc2-5c84-4a8b-a595-b58ec1aa7fbf","task":"Create a contract-based REST API integration with Acumatica and handle endpoint versioning across upgrades","domain":"acumatica","steps":["Authenticate via POST to /entity/auth/login with username, password, company, and branch in the JSON body; the server returns a session cookie used for subsequent requests","Discover available endpoints and their versions via GET /entity/ which returns the list of installed endpoint schemas with their names and version strings","Construct resource URLs as /entity/<EndpointName>/<EndpointVersion>/<EntityName>/<key>; for example /entity/Default/24.200.001/Customer/C000001","Page through collections using $top and $skip query parameters; when the number of returned records is less than $top, you have reached the last page","Store the endpoint version in application configuration rather than hard-coding it; after each Acumatica upgrade, test the new version and update the configuration before deploying to production"],"gotchas":["Calling an endpoint version URL that does not exist on the target instance returns 404; after an upgrade the old version URL may be removed — always verify in the sandbox after upgrades","Acumatica's contract-based API uses cookie-based session authentication by default; sessions expire after inactivity and require re-login — implement session refresh or use the OAuth 2.0 flow available in newer versions","Fields not included in the endpoint contract schema are invisible to the API even if they appear in the UI; extend the endpoint in Acumatica's customisation project if you need additional fields"],"contributor":"waymark-seed","created":"2026-06-12T08:27:56.245Z","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":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/38f87fc2-5c84-4a8b-a595-b58ec1aa7fbf"}