---
title: "Changes to Create Org"
method: POST
path: "/api/v1/orgs"
---

# Changes to Create Org

`POST /api/v1/orgs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 20 revisions.

- **2026-10-26** `3e25bef24f8f`: 3 warning, 1 info
- **2026-10-05** `38e8e6901817`: 1 info
- **2026-09-27** `b20a3bdd6219`: 4 warning, 4 info
- **2026-09-23** `9ae16e2960de`: 1 warning
- **2026-08-31** `18ce94490752`: 4 info
- **2026-08-25** `e63bfe8e38b4`: 2 breaking, 1 warning, 1 info

## Changes

- **2026-10-26** `3e25bef24f8f`: 3 warning, 1 info
  - added the new `connect` enum value to the `onboarding_state/completed_steps/items/` response property for the response status `201`
  - added the new `discover` enum value to the `onboarding_state/completed_steps/items/` response property for the response status `201`
  - added the new `govern` enum value to the `onboarding_state/completed_steps/items/` response property for the response status `201`
  - added the optional property `onboarding_state/track` to the response with the `201` status
- **2026-10-05** `38e8e6901817`: 1 info
  - added the optional property `features` to the response with the `201` status
- **2026-09-27** `b20a3bdd6219`: 4 warning, 4 info
  - removed the optional property `onboarding_state/proxy_id` from the response with the `201` status
  - added the new `agent` enum value to the `onboarding_state/completed_steps/items/` response property for the response status `201`
  - added the new `agents` enum value to the `viewer_product_tour_state/current_step` response property for the response status `201`
  - added the new `agents` enum value to the `viewer_product_tour_state/visited_steps/items/` response property for the response status `201`
  - added the optional property `onboarding_state/agent_id` to the response with the `201` status
  - removed the `proxies` enum value from the `viewer_product_tour_state/current_step` response property for the response status `201`
  - removed the `proxies` enum value from the `viewer_product_tour_state/visited_steps/items/` response property for the response status `201`
  - removed the `proxy` enum value from the `onboarding_state/completed_steps/items/` response property for the response status `201`
- **2026-09-23** `9ae16e2960de`: 1 warning
  - removed the optional property `metronome_customer_id` from the response with the `201` status
- **2026-08-31** `18ce94490752`: 4 info
  - added the optional property `entitlements` to the response with the `201` status
  - added the required property `onboarding_state` to the response with the `201` status
  - added the required property `viewer_product_tour_eligible` to the response with the `201` status
  - added the required property `viewer_product_tour_state` to the response with the `201` status
- **2026-08-25** `e63bfe8e38b4`: 2 breaking, 1 warning, 1 info
  - added the new required request property `clerk_org_id`
  - removed the required property `workos_org_id` from the response with the `201` status
  - removed the request property `workos_org_id`
  - added the required property `clerk_org_id` to the response with the `201` status

---

[Operation](https://skmtc.dev/xenovia/apis/controlplane/docs/api/v1/orgs/post.md) - [API](https://skmtc.dev/xenovia/apis/controlplane.md) - [Page](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/orgs/post)