---
title: "Changes to Run a deployed Agent"
method: POST
path: "/v1/agents/run"
---

# Changes to Run a deployed Agent

`POST /v1/agents/run`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 23 revisions.

- **2026-03-15** `3517ca6a2c04` — 1 breaking, 1 info
- **2026-03-15** `536abd065ab0` — 13 breaking, 8 info
- **2026-02-11** `c9a09aaa6236` — 1 breaking, 5 info
- **2025-06-09** `10ce21f8546b` — 2 breaking, 4 info
- **2025-03-30** `f8b1d57c6f96` — 1 breaking, 6 info

## Changes

- **2026-03-15** `3517ca6a2c04` — 1 breaking, 1 info
  - removed `subschema #1` from the `message` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `message` request property `anyOf` list
- **2026-03-15** `536abd065ab0` — 13 breaking, 8 info
  - the `message` request property type changed from `string` to no type
  - the response property `additional_metadata/thread_id` became optional for the status `200`
  - the response property `response/items/additionalProperties/llmresponse` became optional for the status `200`
  - the response property `response/items/additionalProperties/reasoning` became optional for the status `200`
  - the response property `response/items/additionalProperties/toolcalls` became optional for the status `200`
  - the response property `response/items/additionalProperties/toolresponse` became optional for the status `200`
  - the response property `usage/credits_charged` became optional for the status `200`
  - the response property `usage/total_credits_charged` became optional for the status `200`
  - response property `additional_metadata/thread_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `response/items/additionalProperties/llmresponse` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `response/items/additionalProperties/reasoning` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `response/items/additionalProperties/toolresponse/items/` response's property type changed from `string` to no type for status `200`
  - removed the required property `response/items/additionalProperties/toolcalls/items/args` from the response with the `200` status
  - added the new optional request property `hitl_decision`
  - added `subschema #1, subschema #2` to the `message` request property `anyOf` list
  - added the optional property `response/items/additionalProperties/hitl` to the response with the `200` status
  - added the optional property `response/items/additionalProperties/toolcalls/items/arguments` to the response with the `200` status
  - added the optional property `response/items/additionalProperties/toolcalls/items/id` to the response with the `200` status
  - the `llmresponse` response's property default value `` was added for the status `200`
  - the `reasoning` response's property default value `` was added for the status `200`
  - the `total_credits_charged` response's property default value `0` was added for the status `200`
- **2026-02-11** `c9a09aaa6236` — 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `200`
  - added the new optional request property `thread_id`
  - added the optional property `request_metadata` to the response with the `200` status
  - added the required property `additional_metadata` to the response with the `200` status
  - added the required property `response` to the response with the `200` status
  - added the required property `usage` to the response with the `200` status
- **2025-06-09** `10ce21f8546b` — 2 breaking, 4 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `reply` from the response with the `200` status
  - added the new optional request property `agent_history`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
- **2025-03-30** `f8b1d57c6f96` — 1 breaking, 6 info
  - the response's body type changed from no type to `object` for status `200`
  - the endpoint scheme security `BearerAuth` was added to the API
  - api tag `Agent Operations` added
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the required property `reply` to the response with the `200` status

---

[Operation](https://skmtc.dev/svahnar/apis/svahnar-apis/docs/v1/agents/run/post.md) · [API](https://skmtc.dev/svahnar/apis/svahnar-apis.md) · [Page](https://skmtc.dev/svahnar/apis/svahnar-apis/changes/v1/agents/run/post)