projects

PATCH /v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}

Changed on Nov 3, 2026

Updates a single Folder.

Request

Base URL
https://dataform.googleapis.com
URL
https://dataform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}
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

foldersIdstring required

Query parameters

updateMaskstring google-fieldmask

Optional. Specifies the fields to be updated in the Folder. If left unset, all fields that can be updated, will be updated. A few fields cannot be updated and will be ignored if specified in the update_mask (e.g. parent_name, team_folder_name).

Request body

containingFolderstring

Optional. The containing Folder resource name. This should take the format: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, or just "" if this is a root Folder. This field can only be updated through MoveFolder.

createTimestring google-datetime

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

creatorIamPrincipalstring

Output only. The IAM principal identifier of the creator of the Folder.

displayNamestring

Required. The Folder'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.

namestring

Identifier. The Folder's name.

teamFolderNamestring

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

updateTimestring google-datetime

Output only. The timestamp of when the Folder was last updated.

Response

Successful response