# Gemini Enterprise for Customer Experience API API

> Gemini Enterprise for Customer Experience API API on Apizie: 40 endpoints (Gets the latest state of a long-running operation. Clients can use this method to poll the operation result…, Updates the specified app version., Deletes a long-running operation. This method indicates that the client is no longer interested in the…, Lists information about the supported locations for this service. This method lists locations based on the…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/dev-tools:google-ces/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:google-ces`
- Category: Dev Tools
- Status: byok
- Source: https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
- Page: https://apizie.tech/api/dev-tools/google-ces
- OpenAPI: https://apizie.tech/api/dev-tools/google-ces/openapi.json



## Endpoints

### Gets the latest state of a long-running operation. Clients can use this method to poll the operation result…
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-operations-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The name of the operation resource. |

### Updates the specified app version.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Identifier. The unique identifier of the app version. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}` |
| updateMask | string | no | Optional. The list of fields to update. If empty, fields `display_name` and `description` will be updated. |
| body | object | yes | JSON request body |

### Deletes a long-running operation. This method indicates that the client is no longer interested in the…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-operations-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The name of the operation resource to be deleted. |

### Lists information about the supported locations for this service. This method lists locations based on the…
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| extraLocationTypes | string | no | Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage. |
| filter | string | no | A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is… |
| name | string | yes | The resource that owns the locations collection, if applicable. |
| pageSize | integer | no | The maximum number of results to return. If not set, the service selects a default. |
| pageToken | string | no | A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. |

### Lists apps in the given project and location.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the apps. See https://google.aip.dev/160 for more details. |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListApps call. |
| parent | string | yes | Required. The resource name of the location to list apps from. |

### Creates a new app in the given project and location.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | string | no | Optional. The ID to use for the app, which will become the final component of the app's resource name. If not provided, a unique ID will… |
| parent | string | yes | Required. The resource name of the location to create an app in. |
| body | object | yes | JSON request body |

### Executes the given tool with the given arguments.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-execute-tool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}` |
| body | object | yes | JSON request body |

### Exports the specified app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-export-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The resource name of the app to export. |
| body | object | yes | JSON request body |

### Generates personalized onboarding suggestions for the Arc zero state: classifies the requesting user (new /…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-generate-onboarding-suggestions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The app whose zero state is being rendered. Format: `projects/{project}/locations/{location}/apps/{app}` |
| body | object | yes | JSON request body |

### Gets the extended agent card for the authenticated agent.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-get-extended-agent-card` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenant | string | yes | Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is… |

### Imports the specified app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-import-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The parent resource name with the location of the app to import. |
| body | object | yes | JSON request body |

### Retrieve the schema of the given tool. The schema is computed on the fly for the given instance of the tool.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-retrieve-tool-schema` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}` |
| body | object | yes | JSON request body |

### Lists agents in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-agents-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the agents. See https://google.aip.dev/160 for more details. |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListAgents call. |
| parent | string | yes | Required. The resource name of the app to list agents from. |

### Creates a new agent in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-agents-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agentId | string | no | Optional. The ID to use for the agent, which will become the final component of the agent's resource name. If not provided, a unique ID… |
| parent | string | yes | Required. The resource name of the app to create an agent in. |
| body | object | yes | JSON request body |

### Cancels the assistant session's in-flight turn, if any: the explicit user stop for a turn running detached…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-assistant-sessions-cancel-assist` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The assistant session whose in-flight turn to cancel. |
| body | object | yes | JSON request body |

### Runs Arc, the AI assistant, for the specified assistant session in a streaming fashion.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-assistant-sessions-stream-chat-a` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The assistant session to be used to run the assistant. Format:… |
| body | object | yes | JSON request body |

### Lists the changelogs of the specified app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-changelogs-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the changelogs. See https://google.aip.dev/160 for more details. The filter string can be used… |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListChangelogs call. |
| parent | string | yes | Required. The resource name of the app to list changelogs from. |

### Batch deletes the specified conversations.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-conversations-batch-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The resource name of the app to delete conversations from. Format: `projects/{project}/locations/{location}/apps/{app}` |
| body | object | yes | JSON request body |

### Lists conversations in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-conversations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the conversations. See https://google.aip.dev/160 for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListConversations call. |
| parent | string | yes | Required. The resource name of the app to list conversations from. |
| source | string | no | Optional. Indicate the source of the conversation. If not set, Source.Live will be applied by default. Will be deprecated in favor of… |
| sources | string | no | Optional. Indicate the sources of the conversations. If not set, all available sources will be applied by default. |

### Lists deployments in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-deployments-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. The maximum number of deployments to return. The service may return fewer than this value. If unspecified, at most 50… |
| pageToken | string | no | Optional. A page token, received from a previous `ListDeployments` call. Provide this to retrieve the subsequent page. When paginating,… |
| parent | string | yes | Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}` |

### Creates a new deployment in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-deployments-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| deploymentId | string | no | Optional. The ID to use for the deployment, which will become the final component of the deployment's resource name. If not provided, a… |
| parent | string | yes | Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}` |
| body | object | yes | JSON request body |

### Sends a message to an agent.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-message-send` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenant | string | yes | Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is… |
| body | object | yes | JSON request body |

### Sends a streaming message to an agent, allowing for real-time interaction and status updates. Streaming…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-message-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenant | string | yes | Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is… |
| body | object | yes | JSON request body |

### Lists examples in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-examples-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the examples. See https://google.aip.dev/160 for more details. |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListExamples call. |
| parent | string | yes | Required. The resource name of the app to list examples from. |

### Creates a new example in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-examples-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| exampleId | string | no | Optional. The ID to use for the example, which will become the final component of the example's resource name. If not provided, a unique… |
| parent | string | yes | Required. The resource name of the app to create an example in. |
| body | object | yes | JSON request body |

### Lists guardrails in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-guardrails-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the guardrails. See https://google.aip.dev/160 for more details. |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListGuardrails call. |
| parent | string | yes | Required. The resource name of the app to list guardrails from. |

### Creates a new guardrail in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-guardrails-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| guardrailId | string | no | Optional. The ID to use for the guardrail, which will become the final component of the guardrail's resource name. If not provided, a… |
| parent | string | yes | Required. The resource name of the app to create a guardrail in. |
| body | object | yes | JSON request body |

### Generates a session scoped token for chat widget to authenticate with Session APIs.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-sessions-generate-chat-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The session name to generate the chat token for. Format: projects/{project}/locations/{location}/apps/{app}/sessions/{session} |
| body | object | yes | JSON request body |

### Initiates a single-turn interaction with the CES agent within a session.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-sessions-run-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| session | string | yes | Required. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/sessions/{session}` |
| body | object | yes | JSON request body |

### Initiates a single-turn interaction with the CES agent. Uses server-side streaming to deliver incremental…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-sessions-stream-run-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| session | string | yes | Required. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/sessions/{session}` |
| body | object | yes | JSON request body |

### Lists tools in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-tools-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the tools. Use "include_system_tools=true" to include system tools in the response. See… |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListTools call. |
| parent | string | yes | Required. The resource name of the app to list tools from. |

### Creates a new tool in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-tools-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The resource name of the app to create a tool in. |
| toolId | string | no | Optional. The ID to use for the tool, which will become the final component of the tool's resource name. If not provided, a unique ID will… |
| body | object | yes | JSON request body |

### Lists toolsets in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-toolsets-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the toolsets. See https://google.aip.dev/160 for more details. |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListToolsets call. |
| parent | string | yes | Required. The resource name of the app to list toolsets from. |

### Creates a new toolset in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-toolsets-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The resource name of the app to create a toolset in. |
| toolsetId | string | no | Optional. The ID to use for the toolset, which will become the final component of the toolset's resource name. If not provided, a unique… |
| body | object | yes | JSON request body |

### Retrieve the list of tools included in the specified toolset.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-toolsets-retrieve-tools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| toolset | string | yes | Required. The name of the toolset to retrieve the tools for. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}` |
| body | object | yes | JSON request body |

### Lists all app versions in the given app.
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filter to be applied when listing the app versions. See https://google.aip.dev/160 for more details. |
| orderBy | string | no | Optional. Field to sort by. Only "name" and "create_time" is supported. See https://google.aip.dev/132#ordering for more details. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. The next_page_token value returned from a previous list AgentService.ListAppVersions call. |
| parent | string | yes | Required. The resource name of the app to list app versions from. |

### Creates a new app version in the given app.
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appVersionId | string | no | Optional. The ID to use for the app version, which will become the final component of the app version's resource name. If not provided, a… |
| parent | string | yes | Required. The resource name of the app to create an app version in. |
| body | object | yes | JSON request body |

### Restores the specified app version. This will create a new app version from the current draft app and…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-apps-versions-restore` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The resource name of the app version to restore. |
| body | object | yes | JSON request body |

### Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the…
`POST https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-operations-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The name of the operation resource to be cancelled. |
| body | object | yes | JSON request body |

### Lists operations that match the specified filter in the request. If the server doesn't support this method,…
`GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-operations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | The standard list filter. |
| name | string | yes | The name of the operation's parent resource. |
| pageSize | integer | no | The standard list page size. |
| pageToken | string | no | The standard list page token. |
| returnPartialSuccess | boolean | no | When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the… |

## Example
```
curl "https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-operations-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Gemini Enterprise for Customer Experience API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/dev-tools:google-ces/ces-projects-locations-operations-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Gemini Enterprise for Customer Experience API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Gemini Enterprise for Customer Experience API itself also needs your own key from googleapis.com.

### Can AI agents use the Gemini Enterprise for Customer Experience API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:google-ces.

### What is the status of the Gemini Enterprise for Customer Experience API API?
Needs your own provider key (bring your own key)