# Dialogflow API . projects . locations . agent . versions

## Instance Methods

Close httplib2 connections.

Creates an agent version. The new version points to the agent instance in the "default" environment.

Delete the specified agent version.

Retrieves the specified agent version.

Returns the list of all versions of the specified agent.

Retrieves the next page of results.

Updates the specified agent version. Note that this method does not allow you to update the state of the agent the given version points to. It allows you to update only mutable properties of the version resource.

### Method Details

`close()`

    Close httplib2 connections.

`create(parent, body=None, x__xgafv=None)`

    Creates an agent version. The new version points to the agent instance in the "default" environment.

    Args:
      parent: string, Required. The agent to create a version for. Supported formats: - `projects//agent` - `projects//locations//agent` (required)
      body: object, The request body.
        The object takes the form of:

    { # You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).
      "createTime": "A String", # Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
      "description": "A String", # Optional. The developer-provided description of this version.
      "name": "A String", # Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`
      "status": "A String", # Output only. The status of this version. This field is read-only and cannot be set by create and update methods.
      "versionNumber": 42, # Output only. The sequential number of this version. This field is read-only which means it cannot be set by create and update methods.
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).
      "createTime": "A String", # Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
      "description": "A String", # Optional. The developer-provided description of this version.
      "name": "A String", # Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`
      "status": "A String", # Output only. The status of this version. This field is read-only and cannot be set by create and update methods.
      "versionNumber": 42, # Output only. The sequential number of this version. This field is read-only which means it cannot be set by create and update methods.
    }

`delete(name, x__xgafv=None)`

    Delete the specified agent version.

    Args:
      name: string, Required. The name of the version to delete. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/` (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
    }

`get(name, x__xgafv=None)`

    Retrieves the specified agent version.

    Args:
      name: string, Required. The name of the version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/` (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).
      "createTime": "A String", # Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
      "description": "A String", # Optional. The developer-provided description of this version.
      "name": "A String", # Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`
      "status": "A String", # Output only. The status of this version. This field is read-only and cannot be set by create and update methods.
      "versionNumber": 42, # Output only. The sequential number of this version. This field is read-only which means it cannot be set by create and update methods.
    }

`list(parent, pageSize=None, pageToken=None, x__xgafv=None)`

    Returns the list of all versions of the specified agent.

    Args:
      parent: string, Required. The agent to list all versions from. Supported formats: - `projects//agent` - `projects//locations//agent` (required)
      pageSize: integer, Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.
      pageToken: string, Optional. The next_page_token value returned from a previous list request.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The response message for Versions.ListVersions.
      "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
      "versions": [ # The list of agent versions. There will be a maximum number of items returned based on the page_size field in the request.
        { # You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).
          "createTime": "A String", # Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
          "description": "A String", # Optional. The developer-provided description of this version.
          "name": "A String", # Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`
          "status": "A String", # Output only. The status of this version. This field is read-only and cannot be set by create and update methods.
          "versionNumber": 42, # Output only. The sequential number of this version. This field is read-only which means it cannot be set by create and update methods.
        },
      ],
    }

`list_next()`

    Retrieves the next page of results.

            Args:
              previous_request: The request for the previous page. (required)
              previous_response: The response from the request for the previous page. (required)

            Returns:
              A request object that you can call 'execute()' on to request the next
              page. Returns None if there are no more items in the collection.

`patch(name, body=None, updateMask=None, x__xgafv=None)`

    Updates the specified agent version. Note that this method does not allow you to update the state of the agent the given version points to. It allows you to update only mutable properties of the version resource.

    Args:
      name: string, Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/` (required)
      body: object, The request body.
        The object takes the form of:

    { # You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).
      "createTime": "A String", # Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
      "description": "A String", # Optional. The developer-provided description of this version.
      "name": "A String", # Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`
      "status": "A String", # Output only. The status of this version. This field is read-only and cannot be set by create and update methods.
      "versionNumber": 42, # Output only. The sequential number of this version. This field is read-only which means it cannot be set by create and update methods.
    }

      updateMask: string, Required. The mask to control which fields get updated.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for: - testing - development - production - etc. For more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions).
      "createTime": "A String", # Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
      "description": "A String", # Optional. The developer-provided description of this version.
      "name": "A String", # Output only. The unique identifier of this agent version. Supported formats: - `projects//agent/versions/` - `projects//locations//agent/versions/`
      "status": "A String", # Output only. The status of this version. This field is read-only and cannot be set by create and update methods.
      "versionNumber": 42, # Output only. The sequential number of this version. This field is read-only which means it cannot be set by create and update methods.
    }