---
title: "Changes to Set the session's goal, replacing any existing one [write]"
method: POST
path: "/sessions/{id}/goal"
---

# Changes to Set the session's goal, replacing any existing one [write]

`POST /sessions/{id}/goal`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-11-02** `e5e8f0229a99`: 2 breaking, 2 warning, 5 info

## Changes

- **2026-11-02** `e5e8f0229a99`: 2 breaking, 2 warning, 5 info
  - added `#/components/schemas/MonetaryAmount` to the `goal/max_spend` response property `oneOf` list for the response status `201`
  - the `goal/consumed_spend` response's property type changed from `object` to no type for status `201`
  - removed the optional property `goal/consumed_spend/amount` from the response with the `201` status
  - removed the optional property `goal/consumed_spend/currency` from the response with the `201` status
  - added the new optional request property `max_no_progress`
  - request property `max_iterations` list-of-types was widened by adding types `null` to media type `application/json`
  - added the optional property `error/request_id` to the response with the `default` status
  - added `#/components/schemas/MonetaryAmount` to the `goal/consumed_spend` response property `allOf` list for the response status `201`
  - removed `subschema #1` from the `goal/max_spend` response property `oneOf` list for the response status `201`

---

[Operation](https://skmtc.dev/agentsky/apis/agentsky-developer-api/docs/sessions/:id/goal/post.md) - [API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [Page](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/goal/post)