# Write Email Page Style

Updates an email’s page background (the colour around the message), default text and link colours, font, width and alignment. The colour behind the content uses update-email-editor-row-style. Text and link colours are copied into blocks when they are added, so set them before adding blocks. Revision-bound, atomic edit; drafts only; publishing is publish-newsletter-email-content.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "editorUrl": {
      "type": "string",
      "description": "Editor URL of the email, as the read returned it",
      "minLength": 12,
      "maxLength": 500
    },
    "contentRevision": {
      "type": "string",
      "description": "The contentRevision of the read this change is based on",
      "minLength": 7,
      "maxLength": 100
    },
    "backgroundColor": {
      "type": [
        "null",
        "string"
      ],
      "description": "Colour around the message, \"#RRGGBB\" or \"transparent\"",
      "default": null,
      "pattern": "^(#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3}|transparent)$"
    },
    "textColor": {
      "type": [
        "null",
        "string"
      ],
      "description": "Default text colour of the whole email",
      "default": null,
      "pattern": "^(#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3}|transparent)$"
    },
    "linkColor": {
      "type": [
        "null",
        "string"
      ],
      "description": "Default colour of every link of the email",
      "default": null,
      "pattern": "^(#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3}|transparent)$"
    },
    "contentWidth": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Width of the message in pixels",
      "default": null,
      "minimum": 320,
      "maximum": 1440
    },
    "fontFamily": {
      "type": [
        "null",
        "string"
      ],
      "description": "Default font of the whole email, by name; see the schema for the names",
      "default": null,
      "enum": [
        "Arial",
        "Courier",
        "Georgia",
        "Helvetica Neue",
        "Lucida Sans",
        "Tahoma",
        "Times New Roman",
        "Trebuchet MS",
        "Verdana",
        "ヒラギノ角ゴ Pro W3",
        "メイリオ"
      ]
    },
    "contentAlign": {
      "type": [
        "null",
        "string"
      ],
      "description": "Where the message sits when the window is wider than it is",
      "default": null,
      "enum": [
        "left",
        "center",
        "right"
      ]
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account the access token works in",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "editorUrl",
    "contentRevision"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "required": [
        "operation",
        "previousContentStatus",
        "contentStatus",
        "emailId",
        "contentRevision",
        "warnings",
        "editorUrl",
        "nextAction",
        "created"
      ],
      "properties": {
        "operation": {
          "type": "string",
          "enum": [
            "replaced",
            "unchanged"
          ],
          "description": "\"replaced\": the stored document is a new one; \"unchanged\": nothing was persisted."
        },
        "previousContentStatus": {
          "type": "string",
          "enum": [
            "draft",
            "published",
            "unpublished_changes"
          ]
        },
        "contentStatus": {
          "type": "string",
          "enum": [
            "draft",
            "published",
            "unpublished_changes"
          ]
        },
        "emailId": {
          "type": "integer"
        },
        "contentRevision": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "editorUrl": {
          "type": "string"
        },
        "created": {
          "type": "array",
          "description": "What this write created, with uuids: after \"addRow\" the row and its columns, after \"addModule\" the block, plus the contentRevision the next write needs. Empty when nothing was created.",
          "items": {
            "type": "object",
            "required": [
              "operation",
              "type",
              "uuid"
            ],
            "properties": {
              "operation": {
                "type": "integer",
                "description": "Position of the creating operation in the request, counted from one."
              },
              "type": {
                "type": "string",
                "enum": [
                  "row",
                  "module"
                ]
              },
              "uuid": {
                "type": "string"
              },
              "kind": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The block kind, for a module."
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Uuids of the columns of a new row, in order; an \"addModule\" addresses one of these."
              }
            }
          }
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "review_and_publish_content",
            "none"
          ],
          "description": "The content action still open: \"review_and_publish_content\" while the stored draft is not the dispatch content."
        }
      }
    },
    {
      "type": "object",
      "required": [
        "error"
      ],
      "properties": {
        "error": {
          "type": "object",
          "required": [
            "code",
            "message",
            "remediation",
            "details"
          ],
          "properties": {
            "code": {
              "type": "string",
              "description": "The machine-readable KlickTipp error code."
            },
            "message": {
              "type": "string"
            },
            "remediation": {
              "type": "string",
              "description": "Who has to act: for example get_again, use_klicktipp_editor, change_document, change_html, retry_later or ask_user_before_retry."
            },
            "details": {
              "type": "object"
            }
          }
        }
      }
    }
  ]
}
```