{"uid":"cap_UVYKaAeqLkrHqkMpoO3EC","slug":"brainiac-ros-topic-schema-diff-1c3ef5b5","name":"BRAINIAC ROS Topic Schema Diff","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/robotics-intelligence/ros-topic-schema-diff?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"files":{"type":"array","items":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"maxItems":20},"cycles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"endedAt":{"type":"string","maxLength":40},"program":{"type":"string","maxLength":160},"robotId":{"type":"string","maxLength":80},"startedAt":{"type":"string","maxLength":40},"workcellId":{"type":"string","maxLength":80},"durationSec":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"samples":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"field":{"type":"string","maxLength":120},"topic":{"type":"string","maxLength":200},"value":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"source":{"type":"string","maxLength":200},"robotId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":5000},"schemas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"side":{"enum":["left","right","a","b"],"type":"string"},"topic":{"type":"string","maxLength":200},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":80},"optional":{"type":"boolean"}},"additionalProperties":false},"maxItems":200},"source":{"type":"string","maxLength":200},"messageType":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":200},"downtime":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"endedAt":{"type":"string","maxLength":40},"message":{"type":"string","maxLength":400},"robotId":{"type":"string","maxLength":80},"category":{"type":"string","maxLength":80},"startedAt":{"type":"string","maxLength":40},"workcellId":{"type":"string","maxLength":80},"durationSec":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"opcuaTags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"path":{"type":"string","maxLength":300},"unit":{"type":"string","maxLength":40},"nodeId":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"dataType":{"type":"string","maxLength":80},"browseName":{"type":"string","maxLength":160},"displayName":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":2000},"plcAlarms":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":120},"code":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"message":{"type":"string","maxLength":400},"severity":{"type":"string","maxLength":40},"controllerId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"protocols":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"role":{"enum":["required","available","controller","device"],"type":"string"},"source":{"type":"string","maxLength":200},"version":{"type":"string","maxLength":80},"features":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":40}},"additionalProperties":false},"maxItems":100},"maintenance":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"robotId":{"type":"string","maxLength":80},"component":{"type":"string","maxLength":160},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"runtimeHours":{"type":"number","maximum":1000000000,"minimum":0},"intervalHours":{"type":"number","maximum":1000000000,"minimum":0},"lastServiceAt":{"type":"string","maxLength":40},"intervalCycles":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"type":"json","example":{"items":[{"topic":"/joint_states","matched":true,"addedFields":["effort"],"typeChanges":[],"removedFields":["velocity"],"leftFieldCount":2,"leftMessageType":"sensor_msgs/JointState","rightFieldCount":2,"messageTypeMatch":true,"rightMessageType":"sensor_msgs/JointState"}],"status":"compared","findings":[{"code":"schema_diff","kind":"conflict","detail":"Caller-supplied left/right topic schemas differ.","subject":"/joint_states"}],"checkedAt":"2026-11-04T21:00:00.000Z","topicCount":1,"limitations":["ROS bag topic samples, schemas, cycles, downtime, OPC UA tags, PLC alarms, maintenance records, and protocol declarations are copied only from labeled fields or text/CSV/JSON exports supplied by the caller.","No live industrial equipment connection is opened and no machine commands are issued.","Binary .bag/.mcap files are not fully decoded here. Supply topic CSV/JSON exports or labeled sample rows. Missing values are not invented.","Anomaly, cycle-time, downtime, and maintenance estimates use only supplied measurements and intervals.","Protocol compatibility compares caller-supplied required versus available protocol names, versions, and features only. Protocol specifications are not invented."],"apiKeyRequired":false,"paidProviderUsed":false,"machineCommandsIssued":false,"liveEquipmentConnected":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FFtpZCiaQzwVhxvd-Zrby","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two sets of ROS topic message schemas and reports field additions, removals, and type changes between them","exampleAgentPrompt":"Compare these two ROS topic schema exports for /joint_states and /cmd_vel — left side is from last week's deployment and right side is from today — and tell me which fields were added, removed, or had type changes.","exampleUseCases":[{"title":"Pre-deployment ROS schema validation","prompt":"I'm about to push a new robot software release. Here are the ROS topic schema exports from the old version and the new version as JSON — can you diff them and flag any fields that were removed or had type changes on /joint_states and /imu/data?"},{"title":"Cross-robot compatibility audit","prompt":"We have two robots running different software builds. I've got their ROS topic schema dumps as CSV exports. Can you compare them and tell me which topics have mismatched message types or missing fields between the two?"},{"title":"CI pipeline schema regression check","prompt":"Here are the before and after ROS topic schema JSONs from our latest CI build — check if any fields were dropped or type-changed on /odom, /scan, or /cmd_vel so we can catch regressions before merging."}],"resultDescription":"Returns a per-topic diff listing added fields, removed fields, and type changes for each ROS topic, along with message type match status, left/right field counts, overall comparison status, structured findings with conflict codes, and a checkedAt timestamp. Also includes a limitations list clarifying that no live equipment is connected and no machine commands are issued.","failureModes":["Missing or malformed schema input — no diff can be produced if left/right schemas are absent or unparseable","Truncated base64 file payload exceeding the 12MB limit","Empty topics array — returns no items in the diff","Ambiguous or unlabeled schema fields — missing values are not invented, so partial schemas yield partial diffs","Input exceeds maxLength constraints on csv/json/text fields (200,000 chars)"],"whenToPreferThis":"Use this endpoint when you need to programmatically compare ROS topic message schemas between two versions, deployments, or robots — especially when looking for field-level breaking changes (additions, removals, type mismatches) across sensor_msgs, geometry_msgs, or custom message types. Prefer it over manual inspection or generic diff tools when inputs are structured ROS schema exports (CSV or JSON) and you need machine-readable conflict findings per topic. Not suitable for live ROS bag decoding or real-time topic monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:48.505Z","isFirstParty":false,"canonicalSlug":"brainiac-ros-topic-schema-diff-1c3ef5b5"}