---
title: "Changes to Update intent content fields (title, objective, outcomes, constraints, etc.). Does NOT change status — use the /status endpoint."
method: PATCH
path: "/api/v1/intents/{id}"
---

# Changes to Update intent content fields (title, objective, outcomes, constraints, etc.). Does NOT change status — use the /status endpoint.

`PATCH /api/v1/intents/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 14 revisions.

- **2026-09-01** `a660c0d36148` — 2 info
- **2026-08-31** `8ef75cba546a` — 4 breaking, 1 info
- **2026-08-27** `e419abb0a327` — 2 breaking, 5 info
- **2026-08-23** `155c812b368b` — 6 info

## Changes

- **2026-09-01** `a660c0d36148` — 2 info
  - added the new optional request property `changeRequestId`
  - added the new optional request property `expectedRepoBodyRevision`
- **2026-08-31** `8ef75cba546a` — 4 breaking, 1 info
  - removed the enum value `could` of the request property `outcomes/items/`
  - removed the enum value `must` of the request property `outcomes/items/`
  - removed the enum value `should` of the request property `outcomes/items/`
  - the `outcomes/items/` request property type changed from `string` to no type
  - added `subschema #1, subschema #2` to the `outcomes/items/` request property `oneOf` list
- **2026-08-27** `e419abb0a327` — 2 breaking, 5 info
  - request property `outcomes/items/` was restricted to a list of enum values
  - the `edgeCases/items/` request property type changed from `string` to `object`
  - added the new optional request property `expectedVersion`
  - added the new `could` enum value to the request property `outcomes/items/`
  - added the new `must` enum value to the request property `outcomes/items/`
  - added the new `should` enum value to the request property `outcomes/items/`
  - added the non-success response with the status `409`
- **2026-08-23** `155c812b368b` — 6 info
  - added the new optional request property `currentState`
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `details` to the response with the `403` status
  - added the optional property `details` to the response with the `404` status
  - added the optional property `details` to the response with the `500` status

---

[Operation](https://skmtc.dev/pathmode/apis/pathmode-api/docs/api/v1/intents/:id/patch.md) · [API](https://skmtc.dev/pathmode/apis/pathmode-api.md) · [Page](https://skmtc.dev/pathmode/apis/pathmode-api/changes/api/v1/intents/:id/patch)