Method
Parameters
string
required
The ID of the data source to retrieve (with or without dashes)
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
object
The parent of the data source’s containing database. This is typically a page, block, or workspace.
Record<string, DatabasePropertyConfigResponse>
The property schema of the data source
boolean
Whether the data source is inline
boolean
Whether the data source is archived
boolean
Whether the data source is in the trash
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
string | null
The public URL of the data source if it is publicly accessible
Example
Error Handling
Related Methods
- dataSources.create - Create a new data source
- dataSources.update - Update a data source
- dataSources.query - Query pages from a data source