notionapi: Client for the 'Notion API'

Description

Enable programmatic interaction with 'Notion' pages, databases, blocks, comments, and users through the 'Notion API' https://developers.notion.com/. Provides both synchronous and asynchronous client interfaces for building workflows and automations that integrate with 'Notion' workspaces. Supports all 'Notion API' endpoints including content creation, data retrieval, and workspace management.

Author(s)

Maintainer: Brenwin Ang brenwinalj@gmail.com [copyright holder]

See Also

Useful links:

• https://brenwin1.github.io/notionapi/

• https://github.com/brenwin1/notionapi

• Report bugs at https://github.com/brenwin1/notionapi/issues

R6 Class for Blocks children endpoint

Description

Handle all block children operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$blocks$children. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• BlocksChildrenEndpoint$new()

• BlocksChildrenEndpoint$list()

• BlocksChildrenEndpoint$append()

Method new()

Initialise block children endpoint. Not to be called directly, e.g., use notion$pages$children instead.

Usage

BlocksChildrenEndpoint$new(client)

Arguments

Method list()

Retrieve a block's children

Usage

BlocksChildrenEndpoint$list(block_id, start_cursor = NULL, page_size = NULL)

Arguments

Details

Endpoint documentation

Method append()

Append block children

Usage

BlocksChildrenEndpoint$append(block_id, children, position = NULL)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Append children to a block
notion$blocks$children$append(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  list(
    list(
      object = "block",
      heading_2 = list(
        rich_text = list(list(
          text = list(content = "Test Heading")
        ))
      )
    )
  ),
  position = list(type = "start")
)


# ----- Retrieve children of a block
notion$blocks$children$list("34033ea0-c1e4-81c4-afa0-d1ec98de4bec")

# ----- Iterate through paginated results
## Not run: 
start_cursor <- NULL
has_more <- FALSE
resps <- list()
i <- 1

while (has_more) {
  resps[[i]] <- notion$blocks$children$list(
    "2926b407e3c44b49a1830609abe6744f",
    start_cursor
  )
  has_more <- resps[[i]][["has_more"]]
  start_cursor <- resps[[i]][["next_cursor"]]
  i <- i + 1
}

## End(Not run)

R6 Class for Blocks Endpoint

Description

Handle all block operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$blocks. Not to be instantiated directly.

Value

A list containing the parsed API response.

Public fields

Methods

Public methods

• BlocksEndpoint$new()

• BlocksEndpoint$retrieve()

• BlocksEndpoint$update()

• BlocksEndpoint$delete()

Method new()

Initialise block endpoint. Not to be called directly, e.g., use notion$blocks instead.

Usage

BlocksEndpoint$new(client)

Arguments

Method retrieve()

Retrieve a block

Usage

BlocksEndpoint$retrieve(block_id)

Arguments

Details

Endpoint documentation

Method update()

Update a block

Usage

BlocksEndpoint$update(block_id, in_trash = NULL, ...)

Arguments

Details

Endpoint documentation

Method delete()

Delete a block

Usage

BlocksEndpoint$delete(block_id)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Retrieve a block
notion$blocks$retrieve("34033ea0-c1e4-8123-be95-e77dcc78e47d")


# ----- Update a block
notion$blocks$update(
  "34033ea0-c1e4-8123-be95-e77dcc78e47d",
  heading_2 = list(
    rich_text = list(list(
      text = list(
        content = "Updated Test Heading"
      )
    ))
  )
)


# ----- Delete a block
notion$blocks$delete(
  "34033ea0-c1e4-8123-be95-e77dcc78e47d"
)

R6 Class for Comments Endpoint

Description

Handle all comments operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$comments. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• CommentsEndpoint$new()

• CommentsEndpoint$create()

• CommentsEndpoint$retrieve()

• CommentsEndpoint$list()

Method new()

Initialise comments endpoint. Not to be called directly, e.g., use notion$comments instead.

Usage

CommentsEndpoint$new(client)

Arguments

Method create()

Create a comment

Usage

CommentsEndpoint$create(
  rich_text,
  parent = NULL,
  discussion_id = NULL,
  attachments = NULL,
  display_name = NULL
)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve comments for a block

Usage

CommentsEndpoint$retrieve(comment_id)

Arguments

Details

Endpoint documentation

Method list()

List comments

Usage

CommentsEndpoint$list(block_id, start_cursor = NULL, page_size = NULL)

Arguments

Examples

notion <- notion_client()

# ----- Create comment
notion$comments$create(
  parent = list(
    page_id = "34033ea0-c1e4-81c4-afa0-d1ec98de4bec"
  ),
  rich_text = list(
    list(
      text = list(
        content = "Hello world!"
      )
    )
  )
)


# ----- Retrieve comment
notion$comments$retrieve("34033ea0-c1e4-8193-a220-001d29ae83c5")


# ----- List un-resolved comments from a page or block
notion$comments$list("34033ea0-c1e4-81c4-afa0-d1ec98de4bec")

R6 Class for Custom Emojis Endpoint

Description

Handle all custom emojis operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$custom_emojis. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• CustomEmojisEndpoint$new()

• CustomEmojisEndpoint$list()

Method new()

Initialise custom emojis endpoint. Not to be called directly, e.g., use notion$custom_emojis instead.

Usage

CustomEmojisEndpoint$new(client)

Arguments

Method list()

List custom emojis

Usage

CustomEmojisEndpoint$list(start_cursor = NULL, page_size = NULL, name = NULL)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

notion$custom_emojis$list()

R6 Class for DataSources Endpoint

Description

Handle all data sources operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$datas_ources. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• DataSourcesEndpoint$new()

• DataSourcesEndpoint$create()

• DataSourcesEndpoint$retrieve()

• DataSourcesEndpoint$list_templates()

• DataSourcesEndpoint$update()

• DataSourcesEndpoint$query()

Method new()

Initialise data sources endpoint. Not to be called directly, e.g., use notion$datasources instead.

Usage

DataSourcesEndpoint$new(client)

Arguments

Method create()

Create a data source

Usage

DataSourcesEndpoint$create(parent, properties, title = NULL, icon = NULL)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve a data source

Usage

DataSourcesEndpoint$retrieve(data_source_id)

Arguments

Details

Endpoint documentation

Method list_templates()

List page templates available for a data source

Usage

DataSourcesEndpoint$list_templates(
  data_source_id,
  name = NULL,
  start_cursor = NULL,
  page_size = NULL
)

Arguments

Method update()

Update a data source

Usage

DataSourcesEndpoint$update(
  data_source_id,
  title = NULL,
  icon = NULL,
  properties = NULL,
  in_trash = NULL,
  parent = NULL
)

Arguments

Method query()

Query a data source

Usage

DataSourcesEndpoint$query(
  data_source_id,
  filter_properties = NULL,
  sorts = NULL,
  filter = NULL,
  start_cursor = NULL,
  page_size = NULL,
  in_trash = NULL,
  result_type = NULL
)

Arguments

Examples

notion <- notion_client()

# ----- Create a data source
notion$data_sources$create(
  list(
    database_id = "ffec20ee-1450-4da8-9904-f4babba0e9c0"
  ),
  properties = list(
    Title = list(
      title = no_config()
    )
  ),
  title = list(list(
    text = list(
      content = "Test data source"
    )
  ))
)


# ----- Update data source
notion$data_sources$update(
  "34033ea0-c1e4-8112-bc3a-000bc940aa45",
  properties = list(
    Status = list(
      status = list(
        options = list(
          list(
            name = "To do",
            color = "red"
          ),
          list(
            name = "Done",
            color = "green"
          )
        )
      )
    )
  )
)


# ----- Retrieve a data source
notion$data_sources$retrieve("34033ea0-c1e4-8112-bc3a-000bc940aa45")


# ----- List data source templates
notion$data_sources$list_templates("34033ea0-c1e4-8112-bc3a-000bc940aa45")


# ----- Query a data source
notion$data_sources$query(
  "34033ea0-c1e4-8112-bc3a-000bc940aa45",
  filter = list(
    property = "Status",
    status = list(
      equals = "To do"
    )
  )
)

R6 Class for Databases Endpoint

Description

Handle all databases operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$databases. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• DatabasesEndpoint$new()

• DatabasesEndpoint$create()

• DatabasesEndpoint$retrieve()

• DatabasesEndpoint$update()

Method new()

Initialise databases endpoint. Not to be called directly, e.g., use notion$databases instead.

Usage

DatabasesEndpoint$new(client)

Arguments

Method create()

Create a database

Usage

DatabasesEndpoint$create(
  parent,
  title = NULL,
  description = NULL,
  is_inline = NULL,
  initial_data_source = NULL,
  icon = NULL,
  cover = NULL
)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve a database

Usage

DatabasesEndpoint$retrieve(database_id)

Arguments

Details

Endpoint documentation

Method update()

Update a database

Usage

DatabasesEndpoint$update(
  database_id,
  parent = NULL,
  title = NULL,
  description = NULL,
  is_inline = NULL,
  icon = NULL,
  cover = NULL,
  in_trash = NULL,
  is_locked = NULL
)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Create a database
notion$databases$create(
  list(
    type = "page_id",
    page_id = "22f33ea0c1e480b99c77d1ab72aedff9"
  ),
  title = list(list(
    text = list(
      content = "Test Database"
    )
  ))
)


# ----- Retrieve a database
notion$databases$retrieve("ffec20ee-1450-4da8-9904-f4babba0e9c0")


# ----- Update a database
notion$databases$update(
  "ffec20ee-1450-4da8-9904-f4babba0e9c0",
  description = list(list(
    text = list(
      content = "For testing purposes"
    )
  )),
  icon = list(
    icon = list(
      name = "calendar",
      color = "gray"
    )
  )
)

R6 Class for File Uploads Endpoint

Description

Handle all file uploads operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$file_uploads. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• FileUploadsEndpoint$new()

• FileUploadsEndpoint$create()

• FileUploadsEndpoint$send()

• FileUploadsEndpoint$complete()

• FileUploadsEndpoint$retrieve()

• FileUploadsEndpoint$list()

Method new()

Initialise file uploads endpoint. Not to be called directly, e.g., use notion$file_uploads instead.

Usage

FileUploadsEndpoint$new(client)

Arguments

Method create()

Create a file upload

Usage

FileUploadsEndpoint$create(
  mode = NULL,
  filename = NULL,
  content_type = NULL,
  number_of_parts = NULL,
  external_url = NULL
)

Arguments

Method send()

Upload a file

Usage

FileUploadsEndpoint$send(file_upload_id, file, part_number = NULL)

Arguments

Method complete()

Complete a multi-part file upload

Usage

FileUploadsEndpoint$complete(file_upload_id)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve a file upload

Usage

FileUploadsEndpoint$retrieve(file_upload_id)

Arguments

Details

Endpoint documentation

Method list()

List file uploads

Usage

FileUploadsEndpoint$list(status = NULL, start_cursor = NULL, page_size = NULL)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Direct upload (files <= 20MB)
# Step 1: Create a File Upload object
(resp <- notion$file_uploads$create("single_part"))
file_upload_id <- resp[["id"]]

# Step 2: Upload file contents
#* replace with your file
path <- file.path(tempdir(), "test.pdf")
writeBin(charToRaw("placeholder"), path)
raw <- readBin(path, "raw", file.size(path))

notion$file_uploads$send(
  file_upload_id,
  list(
    filename = basename(path),
    data = raw
  )
)

# Retrieve the file upload
notion$file_uploads$retrieve(file_upload_id)


# ----- Multi-part upload (files > 20MB)
# Step 1: Split raw content into parts
#* replace with your file
raw <- as.raw(rep(65L, 11 * 1024 * 1024))
mid <- ceiling(length(raw) / 2)
parts <- list(raw[seq_len(mid)], raw[seq(mid + 1L, length(raw))])

# Step 2: Create a File Upload object
(resp <- notion$file_uploads$create(
  mode = "multi_part",
  filename = "test-large.txt",
  number_of_parts = 2L
))
file_upload_id <- resp[["id"]]

# Step 3: Send each part
for (i in seq_along(parts)) {
  notion$file_uploads$send(
    file_upload_id,
    file = list(
      filename = "test-large.txt",
      data = parts[[i]]
    ),
    part_number = as.character(i)
  )
}

# Step 4: Complete the upload
notion$file_uploads$complete(
  file_upload_id
)

# Retrieve the file upload
notion$file_uploads$retrieve(
  file_upload_id
)


# ----- Import external files
notion$file_uploads$create(
  "external_url",
  "dummy.pdf",
  content_type = "application/pdf",
  external_url = "https://github.com/brenwin1/notionapi/blob/main/tests/testthat/test.pdf"
)

R6 Class for Pages Endpoint

Description

Handle all pages operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$pages. Not to be instantiated directly.

Value

A list containing the parsed API response.

Public fields

Methods

Public methods

• PagesEndpoint$new()

• PagesEndpoint$create()

• PagesEndpoint$retrieve()

• PagesEndpoint$move()

• PagesEndpoint$update()

• PagesEndpoint$retrieve_markdown()

• PagesEndpoint$update_markdown()

Method new()

Initialise pages endpoint. Not to be called directly, e.g., use notion$pages instead.

Usage

PagesEndpoint$new(client)

Arguments

Method create()

Create a page

Usage

PagesEndpoint$create(
  parent,
  properties = NULL,
  icon = NULL,
  cover = NULL,
  content = NULL,
  children = NULL,
  markdown = NULL,
  template = NULL,
  position = NULL
)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve page properties

Usage

PagesEndpoint$retrieve(page_id, filter_properties = NULL)

Arguments

Details

Endpoint documentation

Method move()

Move a page

Usage

PagesEndpoint$move(page_id, parent)

Arguments

Details

Endpoint documentation

Method update()

Update attributes of a Notion page

Usage

PagesEndpoint$update(
  page_id,
  properties = NULL,
  icon = NULL,
  cover = NULL,
  is_locked = NULL,
  template = NULL,
  erase_content = NULL,
  in_trash = NULL,
  is_archived = NULL
)

Arguments

Details

Endpoint documentation

Method retrieve_markdown()

Retrieve a page as markdown

Usage

PagesEndpoint$retrieve_markdown(page_id, include_transcript = NULL)

Arguments

Details

Endpoint documentation

Method update_markdown()

Update a page's content as markdown

Usage

PagesEndpoint$update_markdown(
  page_id,
  type,
  update_content = NULL,
  replace_content = NULL,
  insert_content = NULL,
  replace_content_range = NULL
)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Create a page
notion$pages$create(
  list(page_id = "22f33ea0c1e480b99c77d1ab72aedff9"),
  list(
    title = list(list(
      text = list(
        content = "Test Page for notionapi"
      )
    ))
  )
)


# ----- Retrieve a page
notion$pages$retrieve("34033ea0-c1e4-81c4-afa0-d1ec98de4bec")


# ----- Move page into a database
notion$pages$move(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  list(
    data_source_id = "34033ea0-c1e4-8112-bc3a-000bc940aa45"
  )
)


# ----- Update a page
notion$pages$update(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  icon = list(
    icon = list(
      name = "pizza",
      color = "blue"
    )
  )
)


# ----- Use `NA` to send JSON `null` — below removes the page's icon
notion$pages$update(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  icon = NA
)


# ----- Retrieve a page as markdown
notion$pages$retrieve_markdown("34033ea0-c1e4-81c4-afa0-d1ec98de4bec")


# ----- Update/replace a page content
notion$pages$update_markdown(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  "replace_content",
  replace_content = list(
    new_str = '## Updated Test Heading\nUsed markdown{color="blue"}'
  )
)


# ----- Trash a page
notion$pages$update(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  in_trash = TRUE
)

R6 Class for Pages Properties Endpoint

Description

Handle all pages properties operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$pages$properties. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• PagesPropertiesEndpoint$new()

• PagesPropertiesEndpoint$retrieve()

Method new()

Initialise pages properties endpoint. Not to be called directly, e.g., use notion$pages$properties instead.

Usage

PagesPropertiesEndpoint$new(client)

Arguments

Method retrieve()

Retrieve a page property item

Usage

PagesPropertiesEndpoint$retrieve(
  page_id,
  property_id,
  start_cursor = NULL,
  page_size = NULL
)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Retrieve a page property
notion$pages$properties$retrieve(
  "34033ea0-c1e4-81c4-afa0-d1ec98de4bec",
  "%60w%5CX"
)

R6 Class for Users Endpoint

Description

Handle all users operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$users. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• UsersEndpoint$new()

• UsersEndpoint$list()

• UsersEndpoint$retrieve()

• UsersEndpoint$me()

Method new()

Initialise users endpoint. Not to be called directly, e.g., use notion$users instead.

Usage

UsersEndpoint$new(client)

Arguments

Method list()

List all users

Usage

UsersEndpoint$list(start_cursor = NULL, page_size = NULL)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve a user

Usage

UsersEndpoint$retrieve(user_id)

Arguments

Details

Endpoint documentation

Method me()

Retrieve the bot User associated with the API token

Usage

UsersEndpoint$me()

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- List all users
notion$users$list()


# ----- Retrieve a user
notion$users$retrieve("fda12729-108d-4eb5-bbfb-a8f0886794d1")


# ----- Retrieve the bot User associated with the API token
notion$users$me()

R6 Class for Views Endpoint

Description

Handle all views operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$views. Not to be instantiated directly.

Value

A list containing the parsed API response.

Public fields

Methods

Public methods

• ViewsEndpoint$new()

• ViewsEndpoint$create()

• ViewsEndpoint$retrieve()

• ViewsEndpoint$update()

• ViewsEndpoint$delete()

• ViewsEndpoint$list()

Method new()

Initialise views endpoint. Not to be called directly, e.g., use notion$views instead.

Usage

ViewsEndpoint$new(client)

Arguments

Method create()

Create a view

Usage

ViewsEndpoint$create(
  data_source_id,
  name,
  type,
  database_id = NULL,
  view_id = NULL,
  filter = NULL,
  sorts = NULL,
  quick_filters = NULL,
  create_database = NULL,
  configuration = NULL,
  position = NULL,
  placement = NULL
)

Arguments

Details

Endpoint documentation

Method retrieve()

Retrieve a view

Usage

ViewsEndpoint$retrieve(view_id)

Arguments

Details

Endpoint documentation

Method update()

Update a view

Usage

ViewsEndpoint$update(
  view_id,
  name = NULL,
  filter = NULL,
  sorts = NULL,
  quick_filters = NULL,
  configuration = NULL
)

Arguments

Details

Endpoint documentation

Method delete()

Delete a view

Usage

ViewsEndpoint$delete(view_id)

Arguments

Details

Endpoint documentation

Method list()

List all views in a database

Usage

ViewsEndpoint$list(
  database_id = NULL,
  data_source_id = NULL,
  start_cursor = NULL,
  page_size = NULL
)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Create a view
notion$views$create(
  "34033ea0-c1e4-8112-bc3a-000bc940aa45",
  "Test view",
  "table",
  "ffec20ee-1450-4da8-9904-f4babba0e9c0"
)


# ----- Retrieve a view
notion$views$retrieve("34033ea0-c1e4-8192-ac14-000cdad096ce")


# ----- List views
notion$views$list(data_source_id = "34033ea0-c1e4-8112-bc3a-000bc940aa45")


# ----- Update a view
notion$views$update("34033ea0-c1e4-8192-ac14-000cdad096ce", "Updated view name")


# ----- Delete a view
notion$views$delete("34033ea0-c1e4-8192-ac14-000cdad096ce")

R6 Class for Views Queries Endpoint

Description

Handle all views queries operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$views$queries. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• ViewsQueriesEndpoint$new()

• ViewsQueriesEndpoint$create()

• ViewsQueriesEndpoint$results()

• ViewsQueriesEndpoint$delete()

Method new()

Initialise pages properties endpoint. Not to be called directly, e.g., use notion$views$queries instead.

Usage

ViewsQueriesEndpoint$new(client)

Arguments

Method create()

Create a view query

Usage

ViewsQueriesEndpoint$create(view_id, page_size = NULL)

Arguments

Details

Endpoint documentation

Method results()

Get view query results

Usage

ViewsQueriesEndpoint$results(
  view_id,
  query_id,
  start_cursor = NULL,
  page_size = NULL
)

Arguments

Details

Endpoint documentation

Method delete()

Delete a view query

Usage

ViewsQueriesEndpoint$delete(view_id, query_id)

Arguments

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Create a view query
notion$views$queries$create("34033ea0-c1e4-8192-ac14-000cdad096ce")


# ----- Get view query results
notion$views$queries$results(
  "34033ea0-c1e4-8192-ac14-000cdad096ce",
  "9af03bd1-ed79-4842-a57c-0bc04fb61be2"
)


# ----- Delete a view query
notion$views$queries$delete(
  "34033ea0-c1e4-8192-ac14-000cdad096ce",
  "9af03bd1-ed79-4842-a57c-0bc04fb61be2"
)

Create empty property configuration

Description

Helper function that creates an empty named list for property configurations that require no additional settings.

Many database properties like text, checkbox and date do not need configuration settings. This function returns the empty configuration ({} in JSON) that these properties expect.

Usage

no_config()

Value

An empty ⁠named list⁠ that serialises to {} in JSON

Examples

notion <- notion_client()

# ----- Create a data source
notion$data_sources$create(
  list(
    database_id = "5f9759b2-ad71-4b66-880f-d0306614227b"
  ),
  properties = list(
    Title = list(
      title = no_config()
    )
  ),
  title = list(list(
    text = list(
      content = "Test data source"
    )
  ))
)

Notion API client

Description

Main client for interacting with Notion API. This R6 class provides access to all Notion API endpoints through organised sub-objects.

Client Types

• notion_client(): Create a synchronous client (blocks until requests complete)

• async_notion_client(): Create an asynchronous client (non-blocking)

Both clients provide identical interfaces, with the async client inheriting all methods from synchronous client. The only difference is that async methods return promises instead of results directly.

Usage

notion_client(
  auth = NULL,
  base_url = getOption("notionapi.base_url"),
  version = getOption("notionapi.version"),
  timeout = 60000
)

async_notion_client(
  auth = NULL,
  base_url = getOption("notionapi.base_url"),
  version = getOption("notionapi.version"),
  timeout = 60000
)

Value

A Notion API client instance

Configuration fields

• auth: Authentication token. Defaults to NOTION_TOKEN environment variable

• base_url: Base URL for Notion API (defaults to getOption("notionapi.base_url"))

• version: Notion API version (defaults to getOption("notionapi.version"))

• timeout: Timeout for requests in milliseconds (defaults to 60000, or 60 seconds)

Endpoints

• blocks: Blocks endpoint object (BlocksEndpoint)

  • blocks$children: Blocks children endpoint object (BlocksChildrenEndpoint)

• pages: Pages endpoint object (PagesEndpoint)

  • pages$properties: Pages properties endpoint object (PagesPropertiesEndpoint)

• databases: Databases endpoint object (DatabasesEndpoint)

• data_sources: Data sources endpoint object (DataSourcesEndpoint)

• views: Views endpoint object (ViewsEndpoint)

  • views$queries: Views queries endpoint object (ViewsQueriesEndpoint)

• file_uploads: File uploads endpoint object (FileUploadsEndpoint)

• comments: Comments endpoint object (CommentsEndpoint)

• search: Search endpoint (see NotionClient$search() method below)

• users: Users endpoint object (UsersEndpoint)

• custom_emojis: Custom emojis endpoint object (CustomEmojisEndpoint)

Public fields

Methods

Public methods

• NotionClient$new()

• NotionClient$request()

• NotionClient$print()

• NotionClient$search()

Method new()

Initialise Notion Client

Usage

NotionClient$new(
  auth = NULL,
  base_url = getOption("notionapi.base_url"),
  version = getOption("notionapi.version"),
  timeout = 60000
)

Arguments

Method request()

Create a base httr2 request object for the Notion API.

This method is primarily for advanced users who want to make custom API calls or for debugging purposes. Most users should use the endpoint methods instead.

Usage

NotionClient$request()

Returns

httr2 request object

Method print()

Print basic details of Notion Client

Usage

NotionClient$print()

Method search()

Search all parent or child pages and databases shared with an integration

Usage

NotionClient$search(
  sort = NULL,
  query = NULL,
  start_cursor = NULL,
  page_size = NULL,
  filter = NULL
)

Arguments

Details

Endpoint documentation

Super class

notionapi::NotionClient -> AsyncNotionClient

Methods

Public methods

• AsyncNotionClient$new()

• AsyncNotionClient$request()

• AsyncNotionClient$print()

Method new()

Initialise Async Notion Client

Usage

AsyncNotionClient$new(
  auth = NULL,
  base_url = getOption("notionapi.base_url"),
  version = getOption("notionapi.version"),
  timeout = 60000
)

Arguments

Method request()

Create a base httr2 request object for the Notion API.

This method is primarily for advanced users who want to make custom API calls or for debugging purposes. Most users should use the endpoint methods instead.

Usage

AsyncNotionClient$request()

Returns

httr2 request object

Method print()

Print basic details of Notion Client

Usage

AsyncNotionClient$print()

See Also

Notion API documentation

Examples

# ----- Create a Notion client with default configuration
notion <- notion_client()

# ----- Search for pages and databases
notion$search(
  query = "Test Page for notionapi",
  page_size = 1,
  filter = list(
    property = "object",
    value = "page"
  ),
  sort = list(
    timestamp = "last_edited_time",
    direction = "descending"
  )
)


# ----- Async client
## Not run: 
library(promises)
async_notion <- async_notion_client()

# Start multiple requests simultaneously (non-blocking)
p1 <- async_notion$search(
  query = "Testing",
  page_size = 1
)

p2 <- async_notion$users$me()

# Returns a promise object, not particularly useful on its own
p1
p2

# Use promise chaining functions to process results as they complete
p1 %...>%
  print()

p2 %...>%
  print()

# See the [promises package documentation](https://rstudio.github.io/promises/)
# for more information on working with promises

## End(Not run)

Check if Notion token is set

Description

Checks if the NOTION_TOKEN environment variable is set.

Usage

notion_token_exists()

Value

TRUE if the token exists, FALSE otherwise.

Examples

notion_token_exists()

Print the result of a Notion API call

Description

Print the result of a Notion API call

Usage

## S3 method for class 'notion_response'
print(x, ...)

Arguments

Value

The JSON result.

VCR Example Helpers

Description

Internal functions for managing VCR cassettes in package examples. These functions are not intended for direct use by package users.

Usage

vcr_example_start(name)

vcr_example_end()

Arguments