Method
Parameters
object
required
Record<string, PropertyConfiguration>
required
Property schema of the data source. Each key is a property name, and each value is a property configuration object.Supported property types:
title- Title property (required for data sources)rich_text- Rich text contentnumber- Numeric valuesselect- Single select from optionsmulti_select- Multiple selectionsdate- Date or date rangepeople- User referencesfiles- File attachmentscheckbox- Boolean valuesurl- URL stringsemail- Email addressesphone_number- Phone numbersformula- Calculated valuesrelation- Relations to other data sourcesrollup- Aggregate values from relationscreated_time- Automatic creation timestampcreated_by- Automatic creator referencelast_edited_time- Automatic edit timestamplast_edited_by- Automatic editor reference
RichTextItemRequest[]
Title of the data source as it appears in Notion. Array of rich text objects.
PageIconRequest | null
Icon for the data source. Can be an emoji, external URL, or file upload.
string
Bearer token for authentication. Overrides the client-level auth if provided.
Response
Returns aDataSourceObjectResponse or PartialDataSourceObjectResponse.
string
Always
"data_source"string
The unique identifier of the data source
RichTextItemResponse[]
The title of the data source
RichTextItemResponse[]
The description of the data source
object
The parent of the data source (database or another data source)
Record<string, DatabasePropertyConfigResponse>
The property schema of the data source
string
ISO 8601 timestamp when the data source was created
string
ISO 8601 timestamp when the data source was last edited
PartialUserObjectResponse
The user who created the data source
PartialUserObjectResponse
The user who last edited the data source
PageIconResponse | null
The icon of the data source
PageCoverResponse | null
The cover image of the data source
string
The Notion URL of the data source
boolean
Whether the data source is archived
boolean
Whether the data source is in the trash
Example
Related Methods
- dataSources.retrieve - Retrieve a data source by ID
- dataSources.update - Update a data source
- dataSources.query - Query pages from a data source