PATCH /v1/rcs/agents/{id}
Updates the agent’s brand profile. Only DRAFT and REJECTED agents can be updated — agents in PENDING_REVIEW or APPROVED state are read-only. All body fields are optional; send only the fields you want to change.

​
Request

​
Authorization
string
required
Bearer <api_key>
​
id
string
required
Agent ID returned from POST /v1/rcs/agents.
{
  "display_name": "FreshFood Official",
  "description": "Fresh groceries delivered in under 2 hours.",
  "color": "#2D6A4F",
  "logo_url": "https://cdn.freshfood.de/brand/logo-224.png",
  "banner_url": "https://cdn.freshfood.de/brand/banner-1440.png",
  "phone": "+4930123456",
  "email": "support@freshfood.de",
  "website": "https://www.freshfood.de",
  "privacy_policy_url": "https://www.freshfood.de/privacy",
  "terms_of_service_url": "https://www.freshfood.de/terms"
}

​
Brand identity

​
display_name
string
Name shown to users in the RCS messaging app. Typically the brand name. Google requires this to match your registered brand identity.
​
description
string
Short tagline shown in the agent’s profile view. Must not contain HTML, JSON, script content, escaped characters (%2e, %2f, %5c, %25), or OS/Unix command strings.
​
color
string
Hex color used for certain UI elements displayed above the phone number. Must have at minimum a 4.5:1 contrast ratio to white (WCAG 2.0) to pass Google’s review.Example: "#2D6A4F" — verify with WebAIM Contrast Checker.

​
Images

​
logo_url
string
HTTPS URL to the agent’s logo.
  • Dimensions: 224 × 224 px minimum; max 50 kB
  • Logos display as circles in conversations — check that your logo has equal spacing on all sides and does not get clipped
  • Avoid transparent backgrounds: they blend into dark mode and reduce visibility
  • Google makes a copy at submission time; you can remove the source URL afterwards
​
banner_url
string
HTTPS URL to the hero / banner image shown in the agent’s Info & Options screen.
  • Dimensions: 1440 × 448 px (45:14 aspect ratio); max 200 kB; JPEG, JPG, or PNG
  • The logo overlaps the lower portion of the banner — design accordingly

​
Contact

At least one contact method (phone, email, or website) is required for Google to approve the agent for launch.
​
phone
string
Primary support phone number in international format (e.g. +4930123456), e.g. "+4930123456". Multiple phone numbers can be added via the dashboard.
​
email
string
Primary support email address. Must be an individual address belonging to the brand’s organisation.
​
website
string
Primary website URL. Must be reachable and match the brand identity.

​
Compliance

​
privacy_policy_url
string
URL to the brand’s Privacy Policy. Required for Google launch approval.
​
terms_of_service_url
string
URL to the brand’s Terms of Service. Required for Google launch approval.
The fields set at creation — region, billing_category, and use_case — are immutable and cannot be changed via PATCH. If you need different values, create a new agent.newsletter_enabled cannot be changed after the agent has been submitted for review, even if subsequently rejected. Create a new agent to add newsletter capability.

​
Response

Returns the full updated agent record.
{
  "agent_id": "ag_draft_a1b2c3",
  "status": "DRAFT",
  "display_name": "FreshFood Official",
  "description": "Fresh groceries delivered in under 2 hours.",
  "color": "#2D6A4F",
  "logo_url": "https://cdn.freshfood.de/brand/logo-224.png",
  "banner_url": "https://cdn.freshfood.de/brand/banner-1440.png",
  "phone": "+4930123456",
  "email": "support@freshfood.de",
  "website": "https://www.freshfood.de",
  "privacy_policy_url": "https://www.freshfood.de/privacy",
  "terms_of_service_url": "https://www.freshfood.de/terms",
  "updated_at": "2026-03-28T10:00:00Z"
}

Submit for review

Submit for Google / carrier review after completing the profile.

Get agent

Check current status and read rejection reasons.