---
title: "Changes to Test an Agent with YAML configuration"
method: POST
path: "/v1/agents/test"
---

# Changes to Test an Agent with YAML configuration

`POST /v1/agents/test`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 13 of 23 revisions.

- **2026-03-15** `3517ca6a2c04` — 1 info
- **2026-03-15** `d8e757a80870` — 3 info
- **2026-03-15** `536abd065ab0` — 2 breaking, 6 info
- **2026-02-11** `c9a09aaa6236` — 1 info
- **2025-12-18** `2db9e75ea330` — 1 info
- **2025-06-09** `10ce21f8546b` — 2 info
- **2025-04-12** `cd841b21af73` — 1 breaking, 1 info
- **2025-04-12** `5eeb50d15e83` — 1 breaking
- **2025-04-10** `e11278b0bbf7` — 1 info
- **2025-04-09** `2eaefbeb210a` — 1 breaking
- **2025-04-09** `8c933fc940ee` — 1 info
- **2025-04-09** `f6bcb5bc3da6` — 1 warning, 2 info
- **2025-03-30** `f8b1d57c6f96` — 1 info

## Changes

- **2026-03-15** `3517ca6a2c04` — 1 info
  - request property `message` list-of-types was widened by adding types `null` to media type `multipart/form-data`
- **2026-03-15** `d8e757a80870` — 3 info
  - request body became optional
  - the request property `message` became optional
  - request property `message` list-of-types was widened by adding types `object` to media type `multipart/form-data`
- **2026-03-15** `536abd065ab0` — 2 breaking, 6 info
  - request property `agent_history` list-of-types was narrowed by removing types `array and null` from media type `multipart/form-data`
  - the response's body type changed from no type to `object` for status `200`
  - added the new optional request property `hitl_decision`
  - the `agent_history` request property default value changed from `` to `[]`
  - 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
- **2026-02-11** `c9a09aaa6236` — 1 info
  - added the new optional request property `thread_id`
- **2025-12-18** `2db9e75ea330` — 1 info
  - api tag `Agent Operations` added
- **2025-06-09** `10ce21f8546b` — 2 info
  - api operation id `run_agent_v1_agents_test_post` removed and replaced with `test_agent_v1_agents_test_post`
  - added the new optional request property `agent_history`
- **2025-04-12** `cd841b21af73` — 1 breaking, 1 info
  - removed the media type `application/json` from the request body
  - added the media type `multipart/form-data` to the request body
- **2025-04-12** `5eeb50d15e83` — 1 breaking
  - removed `subschema #2` from the `yaml_file` request property `anyOf` list
- **2025-04-10** `e11278b0bbf7` — 1 info
  - endpoint added
- **2025-04-09** `2eaefbeb210a` — 1 breaking
  - api path removed without deprecation
- **2025-04-09** `8c933fc940ee` — 1 info
  - added `subschema #2` to the `yaml_file` request property `anyOf` list
- **2025-04-09** `f6bcb5bc3da6` — 1 warning, 2 info
  - removed the request property `yaml_data`
  - added the new optional request property `yaml_file`
  - added the new optional request property `yaml_string`
- **2025-03-30** `f8b1d57c6f96` — 1 info
  - the endpoint scheme security `BearerAuth` was added to the API

---

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