projects

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

Changed on Nov 3, 2026

Creates a new Repository in a given project and location.

Request

Base URL
https://dataform.googleapis.com
URL
https://dataform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/repositories
Auth
- OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/bigquery
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/bigquery
- 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

Query parameters

repositoryIdstring

Required. The ID to use for the repository, which will become the final component of the repository's resource name.

Request body

containingFolderstring

Optional. The name of the containing folder of the repository. The field is immutable and it can be modified via a MoveRepository operation. Format: projects/*/locations/*/folders/*. or projects/*/locations/*/teamFolders/*.

createTimestring google-datetime

Output only. The timestamp of when the repository was created.

displayNamestring

Optional. The repository's user-friendly name.

internalMetadatastring

Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string.

kmsKeyNamestring

Optional. The reference to a KMS encryption key. If provided, it will be used to encrypt user data in the repository and all child resources. It is not possible to add or update the encryption key after the repository is created. Example: projects/{kms_project}/locations/{location}/keyRings/{key_location}/cryptoKeys/{key}

labelsobject

Optional. Repository user labels.

namestring

Identifier. The repository's name.

npmrcEnvironmentVariablesSecretVersionstring

Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format projects/*/secrets/*/versions/*. The file itself must be in a JSON format.

serviceAccountstring

Optional. The service account to run workflow invocations under.

setAuthenticatedUserAdminboolean

Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository.

teamFolderNamestring

Output only. The resource name of the TeamFolder that this Repository is associated with. This should take the format: projects/{project}/locations/{location}/teamFolders/{teamFolder}. If this is not set, the Repository is not associated with a TeamFolder.

Response

Successful response