---
title: "Revise Integration Shape"
method: PATCH
path: "/v1/templates/{template_id}/integration-shape"
tags: ["templates"]
---

# Revise Integration Shape

`PATCH /v1/templates/{template_id}/integration-shape`

Revise the integration_shape.current, logging the reason in revision_log.

patch: fields to merge into integration_shape.current (top-level keys like
       delivery, surfaces, per_goal_expectations, rationale, open_questions).
reason: free-text explanation — required. Captured in revision_log so the
        MCP can detect drift from the Roxels-authored proposal.

Status transitions: proposed_by_roxels → under_revision on first revision.
Use POST /integration-shape/confirm to mark as confirmed.

## Path parameters

- `template_id` string, required

## Request body

- IntegrationShapeRevision
  - `patch` object, required
  - `reason` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)