---
title: "Changes to Create a project"
method: POST
path: "/v1/projects"
---

# Changes to Create a project

`POST /v1/projects`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 106 revisions.

- **2026-08-05** (v3) `9d68b6f4aead`: 2 warning, 4 info
- **2026-07-31** (v3) `f2fca8f19473`: 2 info
- **2026-07-20** (v3) `bae289777c91`: 16 breaking, 19 warning, 9 info
- **2026-07-19** (v3) `e171f744d209`: 1 breaking
- **2026-07-16** (v3) `2206e58b9040`: 2 info
- **2026-07-14** (v3) `5e18a0a13385`: 1 info
- **2024-01-03** (v3) `bbe11224b60e`: 1 breaking
- **2023-11-17** (v3) `41d4fca4cab8`: 1 warning, 5 info
- **2023-05-26** (v3) `1d2e6706728c`: 9 breaking, 12 warning, 2 info
- **2023-05-10** (v3) `297818aad550`: 2 info
- **2023-04-21** (v3) `196c93bf2075`: 1 info

## Changes

- **2026-08-05** (v3) `9d68b6f4aead`: 2 warning, 4 info
  - removed the request property `config/allOf[#/components/schemas/models.ProjectConfig]/sync_dynamic_event_ack`
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/allOf[#/components/schemas/datastore.ProjectConfig]/sync_dynamic_event_ack` from the response with the `201` status
  - added the new optional request property `config/allOf[#/components/schemas/models.ProjectConfig]/allow_unmatched_dynamic_urls`
  - added the new optional request property `config/allOf[#/components/schemas/models.ProjectConfig]/verify_dynamic_events`
  - added the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/allOf[#/components/schemas/datastore.ProjectConfig]/allow_unmatched_dynamic_urls` to the response with the `201` status
  - added the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/allOf[#/components/schemas/datastore.ProjectConfig]/verify_dynamic_events` to the response with the `201` status
- **2026-07-31** (v3) `f2fca8f19473`: 2 info
  - added the new optional request property `config/allOf[#/components/schemas/models.ProjectConfig]/sync_dynamic_event_ack`
  - added the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/allOf[#/components/schemas/datastore.ProjectConfig]/sync_dynamic_event_ack` to the response with the `201` status
- **2026-07-20** (v3) `bae289777c91`: 16 breaking, 19 warning, 9 info
  - the response property `allOf[subschema #2]/data` became nullable for the status `400`
  - the response property `allOf[subschema #2]/data` became nullable for the status `401`
  - the response property `allOf[subschema #2]/data` became nullable for the status `402`
  - the response property `allOf[subschema #2]/data` became nullable for the status `403`
  - the response property `allOf[subschema #2]/data` became nullable for the status `404`
  - the response property `allOf[subschema #2]/data/api_key/allOf[#/components/schemas/datastore.APIKeyResponse]/expires_at` became nullable for the status `201`
  - the response property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config` became nullable for the status `201`
  - the response property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/deleted_at` became nullable for the status `201`
  - the response property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics` became nullable for the status `201`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `400`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `401`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `402`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `403`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `404`
  - the `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config` response's property type changed from `object` to no type for status `201`
  - the `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics` response's property type changed from `object` to no type for status `201`
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/add_event_id_trace_headers` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/circuit_breaker` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/disable_endpoint` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/max_payload_read_size` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/meta_event` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/multiple_endpoint_subscriptions` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/ratelimit` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/replay_attacks_prevention_enabled` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/request_id_header` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/search_policy` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/signature` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/ssl` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/strategy` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics/endpoints_exist` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics/events_exist` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics/sources_exist` from the response with the `201` status
  - removed the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics/subscriptions_exist` from the response with the `201` status
  - added the new `` enum value to the `allOf[subschema #2]/data/api_key/allOf[#/components/schemas/datastore.APIKeyResponse]/role/type` response property for the response status `201`
  - added the new `` enum value to the `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/type` response property for the response status `201`
  - added the new `` enum value to the request property `config/allOf[#/components/schemas/models.ProjectConfig]/request_id_header/allOf[#/components/schemas/config.RequestIDHeaderProvider]/`
  - added the new `` enum value to the request property `config/allOf[#/components/schemas/models.ProjectConfig]/signature/allOf[#/components/schemas/models.SignatureConfiguration]/header`
  - added `#/components/schemas/datastore.ProjectConfig` to the `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config` response property `allOf` list for the response status `201`
  - added `#/components/schemas/datastore.ProjectStatistics` to the `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/statistics` response property `allOf` list for the response status `201`
  - added `#/components/schemas/handlers.Stub` to the `allOf[subschema #2]/data` response property `allOf` list for the response status `400`
  - …4 more
- **2026-07-19** (v3) `e171f744d209`: 1 breaking
  - the `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/meta_event/pub_sub/google/service_account` response's property type changed from `array` to `string`, and format from no format to `byte` for status `201`
- **2026-07-16** (v3) `2206e58b9040`: 2 info
  - added the new optional request property `config/allOf[#/components/schemas/models.ProjectConfig]/request_id_header`
  - added the optional property `allOf[subschema #2]/data/project/allOf[#/components/schemas/models.ProjectResponse]/config/request_id_header` to the response with the `201` status
- **2026-07-14** (v3) `5e18a0a13385`: 1 info
  - endpoint added
- **2024-01-03** (v3) `bbe11224b60e`: 1 breaking
  - api path removed without deprecation
- **2023-11-17** (v3) `41d4fca4cab8`: 1 warning, 5 info
  - added the new `kafka` enum value to the `allOf[subschema #2]/data/project/config/meta_event/pub_sub/type` response property for the response status `200`
  - added the new optional request property `config/add_event_id_trace_headers`
  - added the new optional request property `config/retention_policy/search_policy`
  - added the optional property `allOf[subschema #2]/data/project/config/add_event_id_trace_headers` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/project/config/meta_event/pub_sub/kafka` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/project/config/retention_policy/search_policy` to the response with the `200` status
- **2023-05-26** (v3) `1d2e6706728c`: 9 breaking, 12 warning, 2 info
  - removed the enum value `base64` of the request property `config/signature/versions/items/encoding`
  - removed the enum value `exponential` of the request property `config/strategy/type`
  - removed the enum value `hex` of the request property `config/signature/versions/items/encoding`
  - removed the enum value `http` of the request property `config/meta_event/type`
  - removed the enum value `incoming` of the request property `type`
  - removed the enum value `linear` of the request property `config/strategy/type`
  - removed the enum value `linear` of the request property `config/strategy/type`
  - removed the enum value `outgoing` of the request property `type`
  - removed the enum value `pub_sub` of the request property `config/meta_event/type`
  - removed the request property `config/meta_event/pub_sub`
  - removed the optional property `allOf[subschema #2]/data/config` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/created_at` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/deleted_at` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/logo_url` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/name` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/organisation_id` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/retained_events` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/statistics` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/type` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/uid` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/updated_at` from the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/api_key` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/project` to the response with the `200` status
- **2023-05-10** (v3) `297818aad550`: 2 info
  - added the new optional request property `config/meta_event`
  - added the optional property `allOf[subschema #2]/data/config/meta_event` to the response with the `200` status
- **2023-04-21** (v3) `196c93bf2075`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getconvoy/apis/convoy-api-reference/docs/v1/projects/post.md) - [API](https://skmtc.dev/getconvoy/apis/convoy-api-reference.md) - [Page](https://skmtc.dev/getconvoy/apis/convoy-api-reference/changes/v1/projects/post)