Dataform API (dataform:v1)

2026-03-27

16 new methods

Additions

    Methods
  • dataform.projects.locations.queryUserRootContents

      Path : v1/{+location}:queryUserRootContents

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}:queryUserRootContents

      HTTP Method : GET

      Parameters :

        location

          Description : Required. Location of the user root folder whose contents to list. Format: projects/*/locations/*

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

          Required : Yes

          Type : string

        pageSize

          Description : Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : Optional. Page token received from a previous `QueryUserRootContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryUserRootFolderContents`, with the exception of `page_size`, must match the call that provided the page token.

          Location : query

          Type : string

        orderBy

          Description : Optional. Field to additionally sort results by. Will order Folders before Repositories, and then by `order_by` in ascending order. Supported keywords: display_name (default), created_at, last_modified_at. Examples: - `orderBy="display_name"` - `orderBy="display_name desc"`

          Location : query

          Type : string

        filter

          Description : Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: - `filter="display_name="MyFolder""`

          Location : query

          Type : string

      Parameter Order : location

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Returns the contents of a caller's root folder in a given location. The root folder contains all resources that are created by the user and not contained in any other folder.

  • dataform.projects.locations.teamFolders.get

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}

      HTTP Method : GET

      Parameters :

        name

          Description : Required. The TeamFolder's name.

          Pattern : ^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Fetches a single TeamFolder.

  • dataform.projects.locations.teamFolders.create

      Path : v1/{+parent}/teamFolders

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders

      HTTP Method : POST

      Parameters :

        parent

          Description : Required. The location in which to create the TeamFolder. Must be in the format `projects/*/locations/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : parent

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Creates a new TeamFolder in a given project and location.

  • dataform.projects.locations.teamFolders.patch

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}

      HTTP Method : PATCH

      Parameters :

        name

          Description : Identifier. The TeamFolder's name.

          Pattern : ^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : Optional. Specifies the fields to be updated in the Folder. If left unset, all fields will be updated.

          Location : query

          Type : string

          Format : google-fieldmask

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Updates a single TeamFolder.

  • dataform.projects.locations.teamFolders.delete

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}

      HTTP Method : DELETE

      Parameters :

        name

          Description : Required. The TeamFolder's name.

          Pattern : ^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Deletes a single TeamFolder.

  • dataform.projects.locations.teamFolders.deleteTree

      Path : v1/{+name}:deleteTree

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:deleteTree

      HTTP Method : POST

      Parameters :

        name

          Description : Required. The TeamFolder's name. Format: projects/{project}/locations/{location}/teamFolders/{team_folder}

          Pattern : ^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Deletes a TeamFolder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs).

  • dataform.projects.locations.teamFolders.queryContents

      Path : v1/{+teamFolder}:queryContents

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:queryContents

      HTTP Method : GET

      Parameters :

        teamFolder

          Description : Required. Name of the team_folder whose contents to list. Format: `projects/*/locations/*/teamFolders/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$

          Location : path

          Required : Yes

          Type : string

        pageSize

          Description : Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : Optional. Page token received from a previous `QueryTeamFolderContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryTeamFolderContents`, with the exception of `page_size`, must match the call that provided the page token.

          Location : query

          Type : string

        orderBy

          Description : Optional. Field to additionally sort results by. Will order Folders before Repositories, and then by `order_by` in ascending order. Supported keywords: `display_name` (default), `create_time`, last_modified_time. Examples: - `orderBy="display_name"` - `orderBy="display_name desc"`

          Location : query

          Type : string

        filter

          Description : Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: - `filter="display_name="MyFolder""`

          Location : query

          Type : string

      Parameter Order : teamFolder

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Returns the contents of a given TeamFolder.

  • dataform.projects.locations.teamFolders.search

      Path : v1/{+location}/teamFolders:search

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/teamFolders:search

      HTTP Method : GET

      Parameters :

        location

          Description : Required. Location in which to query TeamFolders. Format: `projects/*/locations/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

          Required : Yes

          Type : string

        pageSize

          Description : Optional. Maximum number of TeamFolders to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : Optional. Page token received from a previous `SearchTeamFolders` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchTeamFolders`, with the exception of `page_size`, must match the call that provided the page token.

          Location : query

          Type : string

        orderBy

          Description : Optional. Field to additionally sort results by. Supported keywords: `display_name` (default), `create_time`, `last_modified_time`. Examples: - `orderBy="display_name"` - `orderBy="display_name desc"`

          Location : query

          Type : string

        filter

          Description : Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: - `filter="display_name="MyFolder""`

          Location : query

          Type : string

      Parameter Order : location

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Returns all TeamFolders in a given location that the caller has access to and match the provided filter.

  • dataform.projects.locations.folders.get

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}

      HTTP Method : GET

      Parameters :

        name

          Description : Required. The Folder's name.

          Pattern : ^projects/[^/]+/locations/[^/]+/folders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Fetches a single Folder.

  • dataform.projects.locations.folders.create

      Path : v1/{+parent}/folders

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders

      HTTP Method : POST

      Parameters :

        parent

          Description : Required. The location in which to create the Folder. Must be in the format `projects/*/locations/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : parent

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Creates a new Folder in a given project and location.

  • dataform.projects.locations.folders.patch

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}

      HTTP Method : PATCH

      Parameters :

        name

          Description : Identifier. The Folder's name.

          Pattern : ^projects/[^/]+/locations/[^/]+/folders/[^/]+$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : 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).

          Location : query

          Type : string

          Format : google-fieldmask

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Updates a single Folder.

  • dataform.projects.locations.folders.delete

      Path : v1/{+name}

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}

      HTTP Method : DELETE

      Parameters :

        name

          Description : Required. The Folder's name.

          Pattern : ^projects/[^/]+/locations/[^/]+/folders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Deletes a single Folder.

  • dataform.projects.locations.folders.deleteTree

      Path : v1/{+name}:deleteTree

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:deleteTree

      HTTP Method : POST

      Parameters :

        name

          Description : Required. The Folder's name. Format: projects/{project}/locations/{location}/folders/{folder}

          Pattern : ^projects/[^/]+/locations/[^/]+/folders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Deletes a Folder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs).

  • dataform.projects.locations.folders.queryFolderContents

      Path : v1/{+folder}:queryFolderContents

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:queryFolderContents

      HTTP Method : GET

      Parameters :

        folder

          Description : Required. Name of the folder whose contents to list. Format: projects/*/locations/*/folders/*

          Pattern : ^projects/[^/]+/locations/[^/]+/folders/[^/]+$

          Location : path

          Required : Yes

          Type : string

        pageSize

          Description : Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : Optional. Page token received from a previous `QueryFolderContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryFolderContents`, with the exception of `page_size`, must match the call that provided the page token.

          Location : query

          Type : string

        orderBy

          Description : Optional. Field to additionally sort results by. Will order Folders before Repositories, and then by `order_by` in ascending order. Supported keywords: display_name (default), create_time, last_modified_time. Examples: - `orderBy="display_name"` - `orderBy="display_name desc"`

          Location : query

          Type : string

        filter

          Description : Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: - `filter="display_name="MyFolder""`

          Location : query

          Type : string

      Parameter Order : folder

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Returns the contents of a given Folder.

  • dataform.projects.locations.folders.move

      Path : v1/{+name}:move

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:move

      HTTP Method : POST

      Parameters :

        name

          Description : Required. The full resource name of the Folder to move.

          Pattern : ^projects/[^/]+/locations/[^/]+/folders/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Moves a Folder to a new Folder, TeamFolder, or the root location.

  • dataform.projects.locations.repositories.move

      Path : v1/{+name}:move

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:move

      HTTP Method : POST

      Parameters :

        name

          Description : Required. The full resource name of the repository to move.

          Pattern : ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/bigquery
    • https://www.googleapis.com/auth/cloud-platform
    • Description : Moves a Repository to a new location.