> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useparagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Page With Markdown



## OpenAPI

````yaml /actionkit/openapi.json POST /projects/{project_id}/tools/#NOTION_UPDATE_PAGE_WITH_MARKDOWN
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#NOTION_UPDATE_PAGE_WITH_MARKDOWN:
    post:
      summary: Update Page With Markdown
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: NOTION_UPDATE_PAGE_WITH_MARKDOWN
                parameters:
                  type: object
                  properties:
                    pageId:
                      type: string
                      description: >-
                        Page ID : Specify the ID of the Page to Update.
                        (example: "59833787-2cf9-4fdf-8782-e53db20768a5")
                    title:
                      type: string
                      description: >-
                        Title : The title of the page. Required if no properties
                        are provided. Ignored if properties are provided with
                        title.
                    properties:
                      type: object
                      description: >-
                        Properties : The property values to update for the page.
                        The keys are the names or IDs of the property and the
                        values are property values. If a page property ID is not
                        included, then it is not changed. (example: "{
                          "title":[
                            {
                              "text":{
                                "content":"My Page"
                              }
                            }
                          ]
                        }")
                      properties: {}
                    markdownContent:
                      type: string
                      description: >-
                        Markdown Content : The content to update the page with,
                        in Markdown format. If Replace Existing Content is True,
                        this will replace the existing content. If Replace
                        Existing Content is False, this will append to the
                        existing content. (example: "# My Page


                        This is the content of my page in **Markdown** format.


                        - List item 1

                        - List item 2")
                    replaceExisting:
                      type: boolean
                      description: >-
                        Replace Existing Content : If Yes, existing page content
                        will be replaced. If No, new content will be appended.
                    cover:
                      type: object
                      description: >-
                        Cover : The cover image of the new page, represented as
                        an file object
                        (https://developers.notion.com/reference/file-object).
                        (example: "{
                          "external":{
                            "url":"https://upload.wikimedia.org/wikipedia/commons/6/62/Tuscankale.jpg"
                          }
                        }")
                      properties: {}
                    icon:
                      type: object
                      description: >-
                        Icon : The icon of the new page. Either an emoji object
                        (https://developers.notion.com/reference/emoji-object)
                        or an external file object
                        (https://developers.notion.com/reference/file-object).
                        (example: "{
                          "emoji":"🥬"
                        }")
                      properties: {}
                    archived:
                      type: boolean
                      description: >-
                        Archived : Whether the page is archived (deleted). Set
                        to true to archive a page. Set to false to un-archive
                        (restore) a page.
                  required:
                    - pageId
                  x-integration: notion
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````