{"uid":"cap_PRTEuwTYWNy4kaQqXeAYL","slug":"brainiac-rollback-feasibility-check-ffe56649","name":"BRAINIAC Rollback Feasibility Check","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/devops/rollback-feasibility-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"versions":{"type":"array","items":{"type":"object","required":["service_id","current_version","target_version"],"properties":{"service_id":{"type":"string","maxLength":120,"minLength":1},"target_version":{"type":"string","maxLength":80,"minLength":1},"current_version":{"type":"string","maxLength":80,"minLength":1},"previous_version":{"type":"string","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":500,"minItems":1},"migrations":{"type":"array","items":{"type":"object","required":["id","service_id","direction","reversible"],"properties":{"id":{"type":"string","maxLength":120,"minLength":1},"detail":{"type":"string","maxLength":500,"minLength":1},"direction":{"enum":["expand","contract","rewrite","other"],"type":"string"},"reversible":{"type":"boolean"},"service_id":{"type":"string","maxLength":120,"minLength":1}},"additionalProperties":false},"maxItems":1000},"compatibility":{"type":"array","items":{"type":"object","required":["id","service_id","depends_on_service_id","compatible_with_rollback"],"properties":{"id":{"type":"string","maxLength":120,"minLength":1},"service_id":{"type":"string","maxLength":120,"minLength":1},"max_version":{"type":"string","maxLength":80,"minLength":1},"min_version":{"type":"string","maxLength":80,"minLength":1},"depends_on_service_id":{"type":"string","maxLength":120,"minLength":1},"compatible_with_rollback":{"type":"boolean"}},"additionalProperties":false},"maxItems":2000},"max_rto_minutes":{"type":"integer","maximum":525600,"minimum":0},"recovery_procedures":{"type":"array","items":{"type":"object","required":["service_id","procedure"],"properties":{"automated":{"type":"boolean"},"procedure":{"type":"string","maxLength":500,"minLength":1},"service_id":{"type":"string","maxLength":120,"minLength":1},"rto_minutes":{"type":"integer","maximum":525600,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"type":"json","example":{"summary":{"blockers":4,"services":2,"high_blockers":3},"blockers":[{"code":"missing_previous_version","evidence":["Service db has no previous_version to roll back to."],"severity":"high","service_id":"db","remediation":"Supply previous_version for every service in the deployment set."},{"code":"irreversible_migration","evidence":["Migration m1 is marked reversible=false (rewrite)."],"severity":"high","service_id":"db","remediation":"Defer the deployment until a reversible expand/contract path exists, or accept that rollback is blocked.","migration_id":"m1"},{"code":"missing_recovery_procedure","evidence":["No recovery_procedures row was supplied for db."],"severity":"medium","service_id":"db","remediation":"Document a rollback procedure for this service before deploying."},{"code":"incompatible_with_rollback","evidence":["Compatibility constraint c1 sets compatible_with_rollback=false for api depending on db."],"severity":"high","service_id":"api","remediation":"Keep forward-compatible contracts or stage a dual-write/dual-read window before cutting over.","compatibility_id":"c1","depends_on_service_id":"db"}],"feasible":false,"explanations":["Rollback feasibility uses only supplied versions, migrations, compatibility flags, and recovery procedures.","feasible is false when any high-severity blocker is present. No deployment platform is contacted."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r4FogrucUUqY6yTqfi-wC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes service versions, migrations, and dependency compatibility to determine whether a deployment can be safely rolled back, returning a list of blockers and a feasibility verdict.","exampleAgentPrompt":"Before we deploy, check if we can safely roll back: service 'api' is moving from v1.2.0 to v1.3.0 (previous was v1.1.0), it depends on service 'db' going from v3.0.0 to v3.1.0, migration 'm42' on 'db' is a rewrite and marked irreversible, and our max acceptable RTO is 30 minutes.","exampleUseCases":[{"title":"Pre-deployment rollback gate","prompt":"We're about to deploy 'checkout-service' from v2.4.1 to v2.5.0 — the previous version was v2.3.9. There's a database migration 'mig-007' of type 'rewrite' that is NOT reversible. Max RTO is 60 minutes and we have no recovery procedure documented. Can we safely roll back if something goes wrong?"},{"title":"Microservices compatibility check","prompt":"Check rollback feasibility for a multi-service release: 'payments' goes from v4.1.0 to v4.2.0, 'notifications' from v1.0.5 to v1.1.0. The compatibility rule 'compat-3' says notifications depends on payments and compatible_with_rollback is false. Max RTO is 15 minutes. Are there any blockers?"},{"title":"Safe expand-contract migration validation","prompt":"We're deploying 'user-service' from v7.2.0 to v7.3.0 (previous v7.1.0) with an expand-direction migration 'mig-expand-1' that is reversible. Recovery procedure is automated and estimated at 10 minutes, max RTO is 45 minutes. Is rollback feasible and are there any blockers I should know about?"}],"resultDescription":"Returns a JSON object with a 'feasible' boolean verdict, a 'summary' (total services, blocker counts by severity), and a 'blockers' array — each blocker has a code (e.g. irreversible_migration, missing_previous_version), severity (high/medium), affected service_id, human-readable evidence, remediation guidance, and optional migration or compatibility IDs. Also includes explanatory notes on the feasibility logic used.","failureModes":["Missing required fields (service_id, current_version, target_version) returns a validation error","Supplying no previous_version causes a 'missing_previous_version' high-severity blocker","Irreversible migrations generate 'irreversible_migration' high blockers that set feasible=false","Exceeding maxItems limits (500 versions, 1000 migrations, 2000 compatibility) may cause rejection","Payment failure via x402 prevents the call from completing","Malformed version strings (exceeding 80 chars) or empty strings will fail schema validation"],"whenToPreferThis":"Use this endpoint when you need a fast, stateless pre-flight check before deploying a set of services and want to know whether rollback is safe — especially when migrations, cross-service dependencies, or RTO constraints are involved. It is purely analytical (no deployment platform is contacted), making it safe to run speculatively. Prefer this over manual review when you have structured version and migration metadata and want a deterministic blocker report with remediation hints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T18:35:04.619Z","isFirstParty":false,"canonicalSlug":"brainiac-rollback-feasibility-check-ffe56649"}