v1.0.0
OpenAPI 3.1.0

Update a component

US region

Client Libraries

Update a component

Update part of a component: its name, tag, folder, or content.

Path Parameters
  • id
    Type: stringFormat: uuid
    required

    The UUID of the component.

Body
required
application/json

You must provide a body with at least one of the following properties. Omitting a field leaves it unchanged.

  • content
    Type: string

    HTML content

  • name
    Type: string
    min length:  
    1
    max length:  
    255

    Display name of the component. You see this on your Design Studio dashboard. This may be different from the component tag name.

  • parent_folder_id
    Type: string | nullFormat: uuid

    The UUID of the parent folder.

    Omit if you want no change to where the folder or file is located. Include null to move it to your root directory. Or add the UUID of another folder to move it there.

  • tag
    Type: string

    The component tag name, used to reference your component in an email. Learn what characters you can use.

Responses
  • 204

    Component updated

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for put/v1/design_studio/components/{id}
curl https://api.customer.io/v1/design_studio/components/123e4567-e89b-12d3-a456-426614174000 \
  --request PUT \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "custom-footer",
  "tag": "",
  "parent_folder_id": null,
  "content": ""
}'
No Body