Method: projects.locations.studies.trials.create

Adds a user provided Trial to a Study.

HTTP request

POST https://{service-endpoint}/v1/{parent}/trials

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

Path parameters



Required. The resource name of the Study to create the Trial in. Format: projects/{project}/locations/{location}/studies/{study}

Request body

The request body contains an instance of Trial.

Response body

If successful, the response body contains a newly created instance of Trial.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • aiplatform.trials.create

For more information, see the IAM documentation.