---
title: "Generate a fix plan"
method: POST
path: "/api/v1/fix"
tags: ["Fix Plans"]
---

# Generate a fix plan

`POST /api/v1/fix`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/v1/fix`
- Auth: none declared

Generate a remediation plan for missing agent-facing infrastructure.

No authentication required. Rate limited to 3 requests/minute/IP.

## Request body

- FixRequest
  - `url` string, required: Store URL to generate a fix plan for.
  - `check_id` string: Stored check result ID. When it matches the URL, the response includes canonical current-score fields from that stored result.
  - `include_content` boolean: Include generated content snippets in fix ops.
  - `context` 'shopify-app': Optional caller context. Use `shopify-app` for Shopify-specific fix classification.

## Response `200`

Fix plan generated successfully.

- FixPlan
  - `id` string, uuid
  - `store_url` string
  - `platform` string
  - `score_before` integer
  - `score_after_est` integer
  - `grade_before` string
  - `grade_after_est` string
  - `current_score` integer: Canonical stored check score for merchant-facing current-score display. Present when `check_id` matched the requested URL.
  - `current_grade` string: Grade corresponding to `current_score`.
  - `current_score_after_est` integer: Estimated after-fix score projected from `current_score`.
  - `current_grade_after_est` string: Grade corresponding to `current_score_after_est`.
  - `scan_score_before` integer: Fresh plan-scan score used internally when it differs from the stored check baseline.
  - `scan_grade_before` string: Grade corresponding to `scan_score_before`.
  - `ops` FixOp[]
    - `id` string, uuid
    - `type` string
    - `target` string
    - `description` string
    - `impact` 'high' | 'medium' | 'low'
    - `score_impact` number
    - `dimension` string
    - `risk_level` 'apply' | 'manual' | 'platform_managed'
    - `platform` string
    - `generated_content` string
  - `generated_at` string, date-time

## Other responses

- `400`: Invalid JSON body or missing `url` field.
- `422`: URL validation failed.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/agenticcom/apis/colter-public-api.md) · [All operations](https://skmtc.dev/agenticcom/apis/colter-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcom/apis/colter-public-api/revisions/c86a6b9228f0?raw)