apigateway.Resource props.parent not accepting RestAPI

The documentation about apigateway.Resource here: https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.Resource.html has this to say about the parent prop:

parent Type: IResource The parent resource of this resource. You can either pass another Resource object or a RestApi object here.

The last part, in bold, is the problem as it does not seem that a restapi object is being accepted.

Reproduction Steps

const myapi = new apigateway.RestApi(this, 'apigatewayApi');
const resource = new apigateway.Resource(this, 'apigatewayResourceTest', {
    parent: myapi,
    pathPart: 'test'
});

Error Log

(removed my local and project paths)

xxx/@aws-cdk/aws-apigateway/lib/resource.js:163
            restApiId: props.parent.restApi.restApiId,
                                                                  ^
TypeError: Cannot read property 'restApiId' of undefined
    at new Resource (xxx/@aws-cdk/aws-apigateway/lib/resource.js:163:45)

Environment

• **CLI Version :aws-cli/1.16.184 Python/3.7.3 Linux/5.0.0-32-generic botocore/1.12.174
• **Framework Version: CDK 1.14.0
• **OS : Ubuntu Linux.
• **Language :english

---

This is 🐛 Bug Report

[jogold]

parent: myapi.root?

You can also use myapi.root.addResource('test') see README.

[strottos]

Might be worth thinking about updating the documentation, it’s misleading here:

parent (IResource) – The parent resource of this resource. You can either pass another Resource object or a RestApi object here.

https://docs.aws.amazon.com/cdk/api/latest/python/aws_cdk.aws_apigateway/ProxyResource.html