{"uid":"cap_25mj4gee7_wYeIJrAEKmL","slug":"halowerk-iot-digital-twin-field-sync-7fd53afd","name":"Halowerk IoT Digital Twin Field Sync","description":"Groups caller-supplied scalar field changes by field name, selects the highest version, and reports a conflict when equal-version values differ. It does not connect to a twin platform, merge nested documents or resolve semantic conflicts.","url":"https://iot.halowerk.com/v1/digital-twin-sync","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"local_changes":{"type":"array","items":{"type":"object","required":["field","value","version"],"properties":{"field":{"type":"string","maxLength":256,"minLength":1},"value":{"type":["string","number","boolean","null"]},"version":{"type":"integer","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":10000},"remote_changes":{"type":"array","items":{"type":"object","required":["field","value","version"],"properties":{"field":{"type":"string","maxLength":256,"minLength":1},"value":{"type":["string","number","boolean","null"]},"version":{"type":"integer","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":10000}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jpaVlETFqk4t3mYnPobLk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Groups scalar field changes from local and remote sources by field name, selects the highest-version value as the winner, and flags conflicts where equal-version values differ.","exampleAgentPrompt":"I need to sync my device's local field changes with the remote twin state — local has 'temperature' at value 72 version 5 and 'humidity' at 60 version 3, while remote has 'temperature' at 70 version 4 and 'humidity' at 65 version 3. Can you merge these and flag any conflicts?","exampleUseCases":[{"title":"Edge device shadow reconciliation","prompt":"My edge sensor just came back online after being offline — local changes include 'battery_level' value 0.82 version 12, 'door_open' value true version 9; remote has 'battery_level' value 0.91 version 11, 'door_open' value false version 9. Merge these and tell me which values win and whether any conflicts exist."},{"title":"Dual-source IoT property conflict detection","prompt":"I have two sets of updates for a smart lock: local says 'lock_state' is 'locked' at version 7 and 'last_seen' is 1700000100 at version 3; remote says 'lock_state' is 'unlocked' at version 7 and 'last_seen' is 1700000050 at version 4. Which values should I keep and are there any version conflicts I need to resolve?"},{"title":"Fleet firmware state merge","prompt":"After a partial OTA push, some devices have local field 'fw_version' set to '2.4.1' at version 20 and remote has it as '2.3.9' at version 18, plus 'config_hash' is '0xABCD' version 5 locally and '0xEFGH' version 5 remotely. Sync these fields and tell me where the versions clash."}],"resultDescription":"Returns a merged set of scalar field states where each field is resolved to the value with the highest version number; any field where local and remote share the same version but carry different values is reported as a conflict. No platform connection or nested document merging is performed — output is a flat field-level reconciliation result.","failureModes":["Duplicate field entries with ambiguous versions may produce unpredictable winner selection","Fields with version numbers at the maximum integer boundary (1000000000000) may cause overflow edge cases","Non-scalar (nested object) values are not supported and will be rejected or ignored","Arrays exceeding 10,000 items will be rejected with a validation error","Missing required fields (field, value, version) on any item will cause a 400 error","Semantic conflicts (e.g. unit mismatches) are not detected — only version-level equality conflicts are flagged"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, stateless, version-based last-write-wins merge of flat scalar IoT fields without connecting to a full digital twin platform. It is ideal for edge-to-cloud reconciliation, offline-sync catch-up, or pre-flight conflict checking before committing state. Prefer alternatives if you need nested document merging, semantic conflict resolution, or direct integration with a twin platform like Azure Digital Twins or AWS IoT Device Shadow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:54.353Z","isFirstParty":false}