Method: projects.locations.metadataStores.contexts.addContextChildren

Adds a set of contexts as children to a parent Context. If any of the child contexts have already been added to the parent Context, they are simply skipped. If this call would create a cycle or cause any Context to have more than 10 parents, the request will fail with an INVALID_ARGUMENT error.

HTTP request

POST https://{service-endpoint}/v1/{context}:addContextChildren

Where {service-endpoint} is one of the supported service endpoints.

Path parameters



Required. The resource name of the parent Context.

Format: projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}

Request body

The request body contains data with the following structure:

JSON representation
  "childContexts": [


The resource names of the child contexts.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the context resource:

  • aiplatform.contexts.addContextChildren

For more information, see the IAM documentation.