---
title: "POST /v1/{+parent}/trials:suggest"
method: POST
path: "/v1/{+parent}/trials:suggest"
tags: ["projects"]
---

# POST /v1/{+parent}/trials:suggest

`POST /v1/{+parent}/trials:suggest`

Adds one or more trials to a study, with parameter values suggested by AI Platform Vizier. Returns a long-running operation associated with the generation of trial suggestions. When this long-running operation succeeds, it will contain a SuggestTrialsResponse.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudMlV1SuggestTrialsRequest — The request message for the SuggestTrial service method.
  - `clientId` string — Required. The identifier of the client that is requesting the suggestion. If multiple SuggestTrialsRequests have the same `client_id`, the service will return the identical suggested trial if the trial is pending, and provide a new trial if the last suggested trial was completed.
  - `suggestionCount` integer — Required. The number of suggestions requested.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/ml.md) · [All operations](https://skmtc.net/google/apis/ml/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/ml/versions/2135f4d5ddf1/schema)