---
title: "Update an RCS brand"
method: PATCH
path: "/rcs/brands/{id}"
tags: ["RCS Brands"]
---

# Update an RCS brand

`PATCH /rcs/brands/{id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/rcs/brands/{id}`
- Auth: HTTP bearer

Updates one or more fields on a brand while its status is `CREATED`. Submitted brands cannot be changed.

## Path parameters

- `id` string, uuid, required

## Request body

- BrandUpdateRequest
  - `display_name` string
  - `legal_name` string
  - `legal_entity_type` 'LIMITED_LIABILITY_COMPANY' | 'SOLE_PROPRIETORSHIP' | 'PARTNERSHIP' | 'CORPORATION' | 'S_CORPORATION'
  - `organization_type` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' | 'UNKNOWN'
  - `website_url` string, uri
  - `profile_id` string
  - `identifiers` BrandIdentifiers: Named business identifiers. Use the `ein` key for the required EIN and `stock_symbol` for a public-profit brand's stock symbol.
    - `ein` EinBrandIdentifier, required
      - `identifier_type` 'EIN', required
      - `value` string, required: Nine digits, optionally formatted as NN-NNNNNNN.
    - `stock_symbol` StockSymbolBrandIdentifier
      - `identifier_type` 'STOCK_SYMBOL', required
      - `value` string, required: A stock symbol using EXCHANGE:SYMBOL.
  - `addresses` object
  - `contacts` BrandContacts: Named business contacts. Use the `brand` key for the required BRAND contact.
    - `brand` object, required
      - `contact_type` 'BRAND', required
      - `first_name` string, required
      - `last_name` string, required
      - `title` string, nullable
      - `email` string, email, required
      - `phone_number` string, required

## Response `200`

The updated RCS brand.

- BrandResponse
  - `brand_id` string, uuid, required
  - `display_name` string, required
  - `legal_name` string, required
  - `legal_entity_type` string, required
  - `organization_type` string, required
  - `website_url` string, uri, required
  - `status` 'CREATED' | 'CONFIGURED' | 'SUBMITTED' | 'REVIEWING' | 'VETTING' | 'VERIFIED' | 'REJECTED' | 'FAILED', required
  - `profile_id` string, nullable, required
  - `identifiers` object, required
  - `addresses` object, required
  - `contacts` object, required
  - `capabilities` CapabilitiesResponse, required
    - `brand_entity` boolean, required
    - `brand_verification` boolean, required
    - `submission_sections` boolean, required
    - `distinct_launch_phase` boolean, required
    - `per_carrier_approval` boolean, required
    - `templates` boolean, required
    - `campaigns` boolean, required
    - `vendor_webhooks` boolean, required
    - `invite_test_devices` boolean, required

## Other responses

- `401`: The request is not authenticated.
- `404`: The resource does not exist, is not owned by the organization, or the provider does not support the requested capability.
- `409`: The operation is not allowed in the current lifecycle state or the idempotency key was used for a different request.
- `422`: The request body or parameters failed validation.
- `503`: A registration dependency is temporarily unavailable.

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/rcs/brands/:id/patch.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)