projects

POST /v1/projects/{projectsId}/locations/{locationsId}/tuningJobs

Changed on Nov 6, 2026

Creates a tuning job. A created tuning job will be subsequently executed to start the model tuning process.

Request

Base URL
https://aiplatform.googleapis.com
Auth
- OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/aiplatform
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/aiplatform
- or OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/cloud-platform
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform

Path parameters

projectsIdstring required

locationsIdstring required

Request body

baseModelstring

The base model that is being tuned. See Supported models.

createTimestring google-datetime

Output only. Time when the TuningJob was created.

descriptionstring

Optional. The description of the TuningJob.

endTimestring google-datetime

Output only. Time when the TuningJob entered any of the following JobStates: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED, JOB_STATE_EXPIRED.

experimentstring

Output only. The Experiment associated with this TuningJob.

gcsMetricsUristring

Output only. The Cloud Storage metrics URI associated with this TuningJob.

labelsobject

Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.

namestring

Output only. Identifier. Resource name of a TuningJob. Format: projects/{project}/locations/{location}/tuningJobs/{tuning_job}

serviceAccountstring

The service account that the tuningJob workload runs as. If not specified, the Vertex AI Secure Fine-Tuned Service Agent in the project will be used. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-secure-fine-tuning-service-agent Users starting the pipeline must have the iam.serviceAccounts.actAs permission on this service account.

startTimestring google-datetime

Output only. Time when the TuningJob for the first time entered the JOB_STATE_RUNNING state.

Output only. The detailed state of the job.

tunedModelDisplayNamestring

Optional. The display name of the TunedModel. The name can be up to 128 characters long and can consist of any UTF-8 characters. For continuous tuning, tuned_model_display_name will by default use the same display name as the pre-tuned model. If a new display name is provided, the tuning job will create a new model instead of a new version.

updateTimestring google-datetime

Output only. Time when the TuningJob was most recently updated.

Response

Successful response