List Components

GET

/api/v1/workspaces/{workspace_id}/email_design_systems/{emailDesignSystemId}/components

Retrieves the components.

Authorizations

• CookieAuth
• BearerAuth

Parameters

Path Parameters

workspace_id

required

integer

Workspace ID

emailDesignSystemId

required

integer

Email Design System ID

Query Parameters

brand_profile_id

integer

Brand Profile ID

Responses

200

Successful

object

results

required

Array<object>

object

id

required

integer

Example

12345

name

required

string

Example

MyComponent

label

required

string

Example

My Component

description

required

string

nullable

Example

A hero banner image with a headline and image, body text and a call to action button.

email_design_system_id

required

integer

Example

12345

updated_at

required

string format: date-time

Example

2023-08-23T10:30:00.000Z

created_at

required

string format: date-time

Example

2023-08-23T10:30:00.000Z

container

boolean

nullable

template

required

string

Example

<div>My Component</div>

field_definitions

required

Array

One of:

object

object

type

required

string

Allowed values: text

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

min_length

integer

max_length

integer

must_not_be_blank

boolean

must_not_be_default

boolean

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

object

object

type

required

string

Allowed values: number

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

number

validations

object

min

number

max

number

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

object

object

type

required

string

Allowed values: enum

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

options

required

Array<object>

object

label

required

string

value

required

string

icon_url

string

nullable

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

object

object

type

required

string

Allowed values: boolean

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

boolean

validations

object

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

object

object

type

required

string

Allowed values: url

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

must_not_be_blank

boolean

must_not_be_default

boolean

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

skip_link_tracking

required

boolean

nullable

object

object

type

required

string

Allowed values: image

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

must_not_be_blank

boolean

must_not_be_default

boolean

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

object

object

type

required

string

Allowed values: color

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

object

object

type

required

string

Allowed values: rich_text

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

max_content_length

integer

min_content_length

integer

must_not_be_blank

boolean

must_not_be_default

boolean

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

marks

required

object

bold

required

object

enabled

required

boolean

italic

required

object

enabled

required

boolean

link

required

object

enabled

required

boolean

bullet_list

required

object

enabled

required

boolean

numbered_list

required

object

enabled

required

boolean

Example

{
  "bold": {
    "enabled": true
  },
  "italic": {
    "enabled": true
  },
  "link": {
    "enabled": true
  },
  "bullet_list": {
    "enabled": true
  },
  "numbered_list": {
    "enabled": true
  }
}

custom_styles_names

required

Array<string>

nullable

object

object

type

required

string

Allowed values: code

label

required

string

group

string

nullable

liquid_variable

required

string

visible_if

string

default_value

required

string

validations

object

must_not_be_blank

boolean

must_not_be_default

boolean

hint

string

hidden_in_editor

boolean

hidden_from_ai

boolean

feed_field_name

string

nullable

screenshot_url

required

string

Example

https://www.example.com/screenshot.png

position

required

integer

nullable

Example

1

last_updated_by

required

object

id

required

integer

Example

12345

first_name

required

string

Example

John

last_name

required

string

Example

Smith

profile_image_url

required

string

nullable

Example

https://example.com/profile.jpg

feed_id

required

integer

nullable

Example

12345

deprecated

required

boolean

401

Unauthorized

object

message

required

string

Example

Record not found

403

Forbidden

object

message

required

string

Example

Record not found