---
title: "Changes to Create an agent and admit its first run"
method: POST
path: "/agents"
---

# Changes to Create an agent and admit its first run

`POST /agents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `8c6b16fe0a3b`: 1 breaking, 2 warning, 6 info

## Changes

- **2026-11-03** `8c6b16fe0a3b`: 1 breaking, 2 warning, 6 info
  - the response property `run/allOf[subschema #2]/response/allOf[#/components/schemas/RunResponse]/tables/items/workspaceId` became nullable for the status `202`
  - added the new `ACCOUNT_BLOCKED` enum value to the `code` response property for the response status `402`
  - added the new `BUDGET_EXCEEDED` enum value to the `code` response property for the response status `402`
  - request property `workspaceId` deprecated
  - added the optional property `blockedByBudgets` to the response with the `402` status
  - added the optional property `reason` to the response with the `402` status
  - response property `agent/workspaceId` deprecated
  - response property `run/allOf[subschema #2]/response/allOf[#/components/schemas/RunResponse]/tables/items/workspaceId` deprecated
  - response property `run/allOf[subschema #2]/workspaceId` deprecated

---

[Operation](https://skmtc.dev/origami/apis/origami-agent-api/docs/agents/post.md) - [API](https://skmtc.dev/origami/apis/origami-agent-api.md) - [Page](https://skmtc.dev/origami/apis/origami-agent-api/changes/agents/post)