---
title: "Re-score an existing plan"
method: POST
path: "/clone"
---

# Re-score an existing plan

`POST /clone`

Re-score an existing district plan to update to the most recent versions of the model
or to change parts of the description and other configuration details.

District plans shared with PlanScore are kept indefinitely.

## Request body

- CloneRequest
  - `id` string, required — Unique identifier of the existing plan to re-score
  - `description` string — Short description of the plan (optional, will override original if provided)
  - `incumbents` string[] — Ordered list of incumbency scenario strings for each district
  - `vote_swings` number[] — Ordered list of vote swings to model for each district
  - `model_version` string — Predictive model version. If omitted, the most recent one is used.
  - `library_metadata` LibraryMetadata — Additional metadata about the plan, particularly for library/historical plans. The following properties are displayed specially in the plan UI, but other properties are also allowed.
    - `authoritative_link` string, uri — URL to the authoritative source for this plan (e.g., state legislature website)
    - `predecessor_link` string, uri — URL to the preceding enacted plan that this plan replaces or succeeds
    - `shapefile_file` string, uri — URL to download the plan as a shapefile
    - `blockassign_file` string, uri — URL to download the block assignment file for this plan
    - `notes` string — Explanatory notes about the plan, its history, or other relevant context

## Response `200`

Plan cloned and re-scoring started successfully

- UploadResponse
  - `index_url` string, uri, required — Machine-readable JSON representation of the plan being scored. The response follows the structure defined in the PlanIndex schema.
  - `plan_url` string, uri, required — Human-readable web page with graphs and maps for the plan

## Other responses

- `400` — Bad request - invalid plan ID or parameters
- `401` — Authentication required
- `404` — Plan not found

---

[API](https://skmtc.dev/planscore/apis/planscore-api.md) · [All operations](https://skmtc.dev/planscore/apis/planscore-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/planscore/planscore-api/revisions/124d888b2d0d/schema)