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

Creates a new Service. Service creation will trigger a new deployment. Use services.get, and check service.status to determine if the Service is ready.

HTTP request

POST https://{endpoint}/apis/{parent}/services

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

Path parameters



Required. The resource's parent. In Cloud Run, it may be one of the following:

  • {project_id_or_number}
  • namespaces/{project_id_or_number}
  • namespaces/{project_id_or_number}/services
  • projects/{project_id_or_number}/locations/{region}
  • projects/{project_id_or_number}/regions/{region} It takes the form namespaces/{namespace}.

Authorization requires the following IAM permission on the specified resource parent:


Query parameters



Indicates that the server should validate the request and populate default values without persisting the request. Supported values: all

Request body

The request body contains an instance of Service.

Response body

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

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.