> This page is for Cash App Pay Partner API. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.cash.app/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server. ### Schema (`response`) ```yaml openapi: 3.1.0 info: title: API version: 1.0.0 paths: /brands/{brand_id}: patch: operationId: subpackageBrands_update-brand summary: Update brand description: >- Updates a brand matching the provided `brand_id` with the given attributes. To clear a field, set it to `null`. Fields that are not provided in the request will not be changed. **This endpoint is not rate limited.** Scopes: `BRANDS_WRITE` tags: - subpackage_brands parameters: - name: brand_id in: path description: ID of the brand. required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/brands_UpdateBrandResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' requestBody: content: application/json: schema: type: object properties: brand: $ref: '#/components/schemas/brands_UpdateBrandRequestBrand' description: Details about the brand to update required: - brand tags: - name: subpackage_brands servers: - url: https://api.cash.app/network/v1 description: Production - url: https://sandbox.api.cash.app/network/v1 description: Sandbox components: schemas: Metadata: type: object additionalProperties: type: string description: >- Freeform key-value pairs of arbitrary data associated with this resource. Keys and values must be passed as strings and not contain any personally identifiable information (PII). Min keys: `0` Max keys: `50` > Note: Nested keys are not supported. title: Metadata brands_UpdateBrandRequestBrand: type: object properties: name: type: string minLength: 1 maxLength: 1024 description: |- Name of the brand to be shown in Cash App next to payments. *This field cannot be cleared.* Min length: `1` Max length: `1024` reference_id: type: string minLength: 1 description: >- A user-defined identifier for this brand, typically used to associate the brand with a record in an external system. Independent from the [merchant reference_id](https://developers.cash.app/docs/api/network-api/operations/create-a-merchant#request-body). *This field cannot be cleared, and must be unique across all brands.* Min length: `1` Max length: `1024` profile_image_url: type: string format: uri minLength: 8 maxLength: 8000 description: >- URL to the image that should be shown in Cash App next to payments made to this brand, typically the brand's logo. The image should be square and be at least 256x256. It must be less than 2MB in filesize. Acceptable image formats: - `png` - `jpg` - `jpeg` *This field cannot be cleared.* Min length: `8` Max length: `8000` color: type: - string - 'null' pattern: ^#[a-fA-F0-9]{6}$ minLength: 7 maxLength: 7 description: >- Primary color associated with this brand and its logo, in 6-digit hex code format. Pattern: `^#[a-fA-F0-9]{6}$` Min length: `7` Max length: `7` metadata: $ref: '#/components/schemas/Metadata' description: Details about the brand to update title: UpdateBrandRequestBrand brands_Brand: type: object properties: id: type: string minLength: 1 maxLength: 128 description: |- A unique identifier for the brand issued by Cash App. Min length: `1` Max length: `128` name: type: string minLength: 1 maxLength: 255 description: |- Name of the brand to be shown in Cash App next to payments. Min length: `1` Max length: `1024` created_at: type: string format: date-time description: >- When this brand was created, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC). updated_at: type: string format: date-time description: >- When this brand was last updated, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC). reference_id: type: string minLength: 1 maxLength: 1024 description: >- A user-defined identifier for this brand, typically used to associate the brand with a record in an external system. Independent from the [merchant reference_id](https://developers.cash.app/docs/api/network-api/operations/create-a-merchant#request-body). Min length: `1` Max length: `1024` color: type: string pattern: ^#[a-fA-F0-9]{6}$ minLength: 7 maxLength: 7 description: >- Primary color associated with this brand and its logo, in 6-digit hex code format (`#f0f0f0`). Min length: `7` Max length: `7` profile_image_url: type: string format: uri pattern: .*\.(png|jpg|jpeg)$ minLength: 8 maxLength: 8000 default: https://example.com description: >- URL to the image that should be shown in Cash App next to payments made to this brand, typically the brand's logo. The image should be square and be at least 256x256. It must be less than 2MB in filesize. Acceptable file formats: - `.png` - `.jpg` - `.jpeg` Min length: `8` Max length: `8000` metadata: $ref: '#/components/schemas/Metadata' required: - id - name - created_at - updated_at - reference_id description: >- A brand is the entity a customer perceives that they are transacting with. title: Brand brands_UpdateBrandResponse: type: object properties: brand: $ref: '#/components/schemas/brands_Brand' title: UpdateBrandResponse ErrorCategory: type: string enum: - API_ERROR - AUTHENTICATION_ERROR - BRAND_ERROR - DISPUTE_ERROR - MERCHANT_ERROR - INVALID_REQUEST_ERROR - PAYMENT_PROCESSING_ERROR - RATE_LIMIT_ERROR - WEBHOOK_ERROR - API_KEY_ERROR - GRANT_ERROR description: The high-level reason the error occurred. title: ErrorCategory Error: type: object properties: category: $ref: '#/components/schemas/ErrorCategory' description: The high-level reason the error occurred. code: type: string description: >- A unique identifier for the specific type of error that occurred. For more information, see [Error Code Reference](/cash-app-pay-partner-api/guides/technical-guides/api-fundamentals/errors/error-code-reference). Min length: `1` detail: type: string description: >- Human-readable description of why the error occurred and how to resolve it. Min length: `1` field: type: string description: >- The field in the request that caused the error, using array and object dot notation. Min length: `1` required: - category - code description: Represents an error encountered during a request to the API. title: Error ErrorResponse: type: object properties: errors: type: array items: $ref: '#/components/schemas/Error' description: |- A list of errors that occurred while processing the request. Min number of items: `1` required: - errors title: ErrorResponse ``` **`Example`** ```json Example { "id": "string", "name": "string", "created_at": "2021-01-01T00:00:00Z", "updated_at": "2021-01-01T00:00:00Z", "reference_id": "example-id", "color": "#ffffff", "profile_image_url": "https://example.com", "metadata": { "my-meta": "meta-value" } } ```