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

# Update an RCS brand

`PATCH /rcs/brands/{id}`

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
  - `addresses` object
  - `contacts` BrandContacts — Named business contacts. Use the `brand` key for the required BRAND contact.
    - `brand` object, required
      - `contact_type` 'BRAND', required
      - `email` string, email, required
      - `first_name` string, required
      - `last_name` string, required
      - `phone_number` string, required
      - `title` string, nullable
  - `display_name` 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.
  - `legal_entity_type` 'LIMITED_LIABILITY_COMPANY' | 'SOLE_PROPRIETORSHIP' | 'PARTNERSHIP' | 'CORPORATION' | 'S_CORPORATION'
  - `legal_name` string
  - `organization_type` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' | 'UNKNOWN'
  - `profile_id` string
  - `website_url` string, uri

## Response `200`

The updated RCS brand.

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

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)