{"slug":"platform/19-api-contracts","title":"19 — API Contracts","section":"platform","sectionLabel":"Platform","status":"unclassified","type":"document","path":"platform/19-api-contracts.mdx","bytes":1026,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n> **Extracted from:** IntegrateWise Platform Specification Suite\n> **Region:** first_pass\n> **Original line:** 1325\n> **Lines:** 17 | **Chars:** 734\n> **Status:** Raw extraction — requires review and canonicalization\n\n19 — API Contracts\n19.1 Versioning\nURI version (/v1/…, migrating to /v2025-09/… for explicit dates).\nDeprecation policy: 6 months notice, sun-set banner, parallel-run.\n19.2 Error model\nCopy{ “code”: “IW-1234”, “message”: “…”, “doc”: “https://…”, “trace_id”: “…” }\nCodes are stable; messages may be translated.\n19.3 Pagination\nCursor-based by default (?cursor=…&limit=…).\nPage size limit max 1000.\n19.4 Feature flags\nX-IW-Feature-Flags header; tenant overrides honor most-specific scope.\n19.5 Configuration system\nServer-driven config: tenant_spine_config (existing) + feature_flags + experiment_assignments.\n19.6 Testing strategy\nContract tests against openapi spec (@integratewise/contract-tests).\nSynthetic tenant population tests.\n"}