Method: projects.locations.endpoints.create

Stay organized with collections Save and categorize content based on your preferences.

Creates an Endpoint.

HTTP request

POST https://{service-endpoint}/v1beta1/{parent}/endpoints

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

Path parameters



Required. The resource name of the Location to create the Endpoint in. Format: projects/{project}/locations/{location}

Query parameters



Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID.

This value should be 1-10 characters, and valid characters are /[0-9]/. When using HTTP/JSON, this field is populated based on a query string argument, such as ?endpointId=12345. This is the fallback for fields that are not included in either the URI or the body.

Request body

The request body contains an instance of Endpoint.

Response body

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

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.endpoints.create

For more information, see the IAM documentation.