---
title: "Changes to Create a data source"
method: POST
path: "/v1/data_sources"
---

# Changes to Create a data source

`POST /v1/data_sources`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 38 revisions.

- **2026-10-26** `52686c6832a8`: 2 info
- **2026-10-21** `981cafc786b6`: 2 info
- **2026-09-03** `86a6ebe86320`: 1 info
- **2026-08-15** `c90a4587bc95`: 1 warning
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
- **2026-08-12** `28d140865fc6`: 2 warning
- **2026-07-31** `301eea0116d9`: 2 warning
- **2026-07-26** `681ee94f046c`: 3 warning

## Changes

- **2026-10-26** `52686c6832a8`: 2 info
  - added the required property `oneOf[#/components/schemas/dataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #6: Relation]/relation/allOf[#/components/schemas/databasePropertyRelationConfigResponseCommon]/limit` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/partialDataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #6: Relation]/relation/allOf[#/components/schemas/databasePropertyRelationConfigResponseCommon]/limit` to the response with the `200` status
- **2026-10-21** `981cafc786b6`: 2 info
  - added the required property `oneOf[#/components/schemas/dataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #5: Status]/status/default_option` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/partialDataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #5: Status]/status/default_option` to the response with the `200` status
- **2026-09-03** `86a6ebe86320`: 1 info
  - added the required property `oneOf[#/components/schemas/dataSourceObjectResponse]/database_type` to the response with the `200` status
- **2026-08-15** `c90a4587bc95`: 1 warning
  - added the new `idempotency_key_reused` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `403`
  - removed `#/components/schemas/publicApiCommonErrorResponse, subschema #2` from the response body `allOf` list for the response status `403`
- **2026-08-12** `28d140865fc6`: 2 warning
  - added the new `agent_credit_limit_reached` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
  - added the new `workspace_credits_exhausted` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
- **2026-07-31** `301eea0116d9`: 2 warning
  - added the new `invalid_beta` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
  - added the new `invalid_credit_limit` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
- **2026-07-26** `681ee94f046c`: 3 warning
  - added the new `agent_deleted` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
  - added the new `directory_not_found` enum value to the `allOf[subschema #2]/code` response property for the response status `404`
  - added the new `status_change_not_allowed` enum value to the `allOf[subschema #2]/code` response property for the response status `403`

---

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