Working with Tables

Table Structure in JSON

Tables in API requests follow a hierarchical structure:

Tables: A list containing multiple table objects.
Name: The table's identifier.
Data: Contains structured sections.
- Sections: Groups of rows with a common header.
- Header: Defines column names.
- Rows: Contains the table's data entries.

Example JSON Structure

{
    "tables": [
        {
            "name": "Table 1",
            "data": {
                "sections": [
                    {
                        "header": [
                            {"text": "Brand"},
                            {"text": "Category"},
                            {"text": "Model"}
                        ],
                        "rows": [
                            [
                                {"text": "BMW"},
                                {"text": "Sedan"},
                                {"text": "5 Series"}
                            ],
                            [
                                {"text": "Toyota"},
                                {"text": "SUV"},
                                {"text": "RAV4"}
                            ],
                            [
                                {"text": "Tesla"},
                                {"text": "Sedan"},
                                {"text": "Model 3"}
                            ]
                        ]
                    }
                ]
            }
        }
    ]
}

Resulted Table

Markdown in Cells

You can include Markdown formatting inside table cells by setting the text value accordingly. Here are examples covering Markdown features:

Example JSON with Markdown:

{
    "tables": [
        {
            "name": "Table 1",
            "data": {
                "sections": [
                    {
                        "header": [
                            {"text": "Markdown"},
                            {"text": "Example"}
                        ],
                        "rows": [
                            [
                                {"text": "Bold"},
                                {"text": "**This is bold text**"}
                            ],
                            [
                                {"text": "Italic"},
                                {"text": "*This is italic text*"}
                            ],
                            [
                                {"text": "Link"},
                                {"text": "[PandaDoc](https://app.pandadoc.com/)"}
                            ],
                            [
                                {"text": "List"},
                                {"text": "- Item 1\n- Item 2\n- Item 3"}
                            ],
                            [
                                {"text": "Numbered List"},
                                {"text": "1. First\n2. Second\n3. Third"}
                            ]
                        ]
                    }
                ]
            }
        }
    ]
}

Resulted Table

Notes

Ensure that name matches an existing table when updating.
Sections and rows should follow the existing structure to maintain consistency.