---
title: "Update the agent's profile at Google"
method: PATCH
path: "/v1/agents/{id}/google"
tags: ["Google & carriers"]
---

# Update the agent's profile at Google

`PATCH /v1/agents/{id}/google`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/agents/{id}/google`
- Auth: HTTP bearer

Editable fields only — hosting region and use case are permanent and billing category is fixed at launch, so they are rejected here rather than sent and refused confusingly. Omitted fields fall back to the brand's own details, which is usually what you want.

Images are fetched and **inspected byte-by-byte**, not just size-checked: a palette PNG is accepted by Google and then re-quantised, which is how one hero image was permanently destroyed. That returns a warning, not a rejection — but it becomes permanent the moment verification is requested.

## Path parameters

- `id` string, required

## Request body

- object
  - `description` string
  - `logoUri` string: Square. Must be directly fetchable — no redirects.
  - `heroUri` string: Banner. Same fetch rules.
  - `color` string: Hex; needs 4.5:1 contrast against white. Check before you send — a colour that looks fine is often 4.3:1.
  - `privacyUrl` string
  - `termsUrl` string
  - `contactEmail` string
  - `contactPhone` string
  - `website` string

## Response `200`

Updated.

- object
  - `ok` boolean, required
  - `profile` object
  - `warnings` string[]: Accepted by Google, but worth fixing before verification freezes them.

## Other responses

- `400`: Invalid profile, or nothing to update.
- `401`: Not signed in, and no account-linked API key was sent.
- `404`: No such agent on this account.
- `409`: Not synced to Google yet.
- `500`: Unexpected server error. The body is always JSON.
- `502`: Google rejected the request.
- `503`: RBM not configured.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)