"callout" blocks should have children

[EndBug]

Describe the bug
Right now callout blocks are defined under the BlockObjectRequestWithoutChildren type, while in reality they do have children, and they should be listed in the BlockObjectRequest union type.
This can be verified by retrieving a callout block with nested children from the API.

This inaccuracy is also present in the docs, that don't show the children property for callout blocks

To Reproduce
Node version:
Notion JS library version: 3.1.2

[leonardo2204]

Any news on this one?

[01-binary]

I encountered the same issue and submitted a PR to fix it: #613

The problem was that callout blocks were incorrectly defined in BlockObjectRequestWithoutChildren, preventing TypeScript users from adding children to callout blocks even though the Notion API supports it.

[01-binary]

Hi @EndBug!

I noticed this issue and created PR #613 to address it, but after investigating further and discussing with the maintainers, I'm having trouble reproducing the exact problem you described.

Looking at the current SDK code, I can see that callout blocks are actually defined in both places:

• BlockObjectRequestWithoutChildren (lines 6595-6602) - without children
• BlockObjectRequest (lines 6962-6970) - with children support

I tried to create test cases to demonstrate where TypeScript would prevent adding children to callout blocks, but I couldn't reproduce specific errors. The type system seems to handle both cases correctly.

Could you provide a specific code example or use case where you encountered this issue? For instance:

• What TypeScript error message did you see?
• What were you trying to accomplish when you hit this limitation?
• Was this in a specific API call or type assignment?

I want to make sure I understand the real problem before proposing a solution. If I misunderstood the issue, I apologize for the confusion!

Thanks for reporting this! 🙏

[Fental]

This code can reproduce.

{
    "object": "block",
    "has_children": true,
    "type": "callout",
    "callout": {
        "rich_text": [],
        "color": "gray_background",
        "children": [
            {
                "object": "block",
                "has_children": true,
                "type": "column_list",
                "column_list": {
                    "children": [
                        {
                            "object": "block",
                            "has_children": true,
                            "type": "column",
                            "column": {
                                "width_ratio": 0.5,
                                "children": [
                                    {
                                        "object": "block",
                                        "has_children": false,
                                        "type": "paragraph",
                                        "paragraph": {
                                            "rich_text": [],
                                            "color": "default"
                                        }
                                    }
                                ]
                            }
                        },
                        {
                            "object": "block",
                            "has_children": true,
                            "type": "column",
                            "column": {
                                "width_ratio": 0.5,
                                "children": [
                                    {
                                        "object": "block",
                                        "has_children": false,
                                        "type": "paragraph",
                                        "paragraph": {
                                            "rich_text": [],
                                            "color": "default"
                                        }
                                    }
                                ]
                            }
                        }
                    ]
                }
            },
            {
                "object": "block",
                "type": "paragraph",
                "paragraph": {
                    "rich_text": [],
                    "color": "default"
                }
            }
        ]
    }
}