---
title: "Update a specific signature"
method: PUT
path: "/1/mail_hostings/{service_mail}/mailboxes/{mailbox}/signatures/{signature}"
tags: ["Mailboxes > Signatures"]
---

# Update a specific signature

`PUT /1/mail_hostings/{service_mail}/mailboxes/{mailbox}/signatures/{signature}`

## Request

- Base URL: `https://api.infomaniak.com`
- URL: `https://api.infomaniak.com/1/mail_hostings/{service_mail}/mailboxes/{mailbox}/signatures/{signature}`
- Auth: HTTP bearer

Update the specified signature

## Path parameters

- `service_mail` integer, required
- `mailbox` string, required
- `signature` integer, required

## Request body

- object
  - `attributes` object
    - `department` string
    - `firstName` string
    - `job` string
    - `lastName` string
    - `mail` string
    - `name` string: Name of the resource `{name}`
    - `nameFormat` string
    - `phones` object[]
      - `type` string
      - `value` string
    - `userAvatarUrl` string
  - `content` string, nullable
  - `form_data` object
    - `globalStyle` object
      - `backgroundColor` string
      - `displaySeparators` boolean
      - `fontColor` string
      - `fontFamily` string
      - `fontSize` string
      - `iconBackgroundColor` string
      - `iconFontColor` 'dark' | 'light'
      - `linkFontColor` string
    - `layout` object
      - `layout` '2-columns' | 'column' | 'custom' | 'default' | 'large-picture-and-text' | 'picture-and-text': Specifies the layout of the template.<note><strong>2-columns</strong>: Layout with two columns.</note><note><strong>column</strong>: Layout with one column.</note><note><strong>custom</strong>: Custom layout with custom html.</note><note><strong>default</strong>: Default layout.</note><note><strong>large-picture-and-text</strong>: Layout with a large picture and text.</note><note><strong>picture-and-text</strong>: Layout with a picture and text.</note>
    - `media` object
      - `accountLogoUrlMode` 'auto' | 'none' | 'static' | 'user': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>auto</strong>: The value of the attributes is automatically derived from the user's information.</note><note><strong>none</strong>: The value of the attributes is not set.</note><note><strong>static</strong>: The value is predefined in the model and remains constant.</note><note><strong>user</strong>: The values of the attributes must be provided by the user during the template creation process.</note>
      - `accountRectangleLogoUrl` string
      - `accountSquareLogoUrl` string
      - `userAvatarUrl` string
      - `userAvatarUrlMode` 'auto' | 'none' | 'static' | 'user': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>auto</strong>: The value of the attributes is automatically derived from the user's information.</note><note><strong>none</strong>: The value of the attributes is not set.</note><note><strong>static</strong>: The value is predefined in the model and remains constant.</note><note><strong>user</strong>: The values of the attributes must be provided by the user during the template creation process.</note>
    - `network` object
      - `backgroundColor` string
      - `fontColor` 'dark' | 'light'
      - `networks` object[]
        - `name` 'Facebook' | 'Instagram' | 'LinkedIn' | 'X' | 'Youtube': Name of the resource `{name}`
        - `url` string
    - `personal` object
      - `department` string: The value of the attribute
      - `departmentMode` 'static' | 'user': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>static</strong>: The value is predefined in the model and remains constant.</note><note><strong>user</strong>: The values of the attributes must be provided by the user during the template creation process.</note>
      - `firstName` string
      - `firstNameMode` 'user'
      - `hasDepartment` boolean: Indicates if the templates contains this attributes or not
      - `hasFirstName` boolean
      - `hasJob` boolean: Indicates if the templates contains this attributes or not
      - `hasLastName` boolean
      - `hasMail` boolean: Indicates if the templates contains this attributes or not
      - `job` string: The value of the attribute
      - `jobMode` 'static' | 'user': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>static</strong>: The value is predefined in the model and remains constant.</note><note><strong>user</strong>: The values of the attributes must be provided by the user during the template creation process.</note>
      - `lastName` string
      - `lastNameMode` 'user'
      - `mail` string: The value of the attribute
      - `mailMode` 'auto' | 'static' | 'user': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>auto</strong>: The value of the attributes is automatically derived from the user's information.</note><note><strong>static</strong>: The value is predefined in the model and remains constant.</note><note><strong>user</strong>: The values of the attributes must be provided by the user during the template creation process.</note>
      - `nameFormat` string: The value of the attribute
      - `nameFormatMode` 'static' | 'user': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>static</strong>: The value is predefined in the model and remains constant.</note><note><strong>user</strong>: The values of the attributes must be provided by the user during the template creation process.</note>
      - `phones` object[]: List of phone numbers associated with the signature template.
        - `type` 'mobile_icon' | 'mobile_letter' | 'none' | 'phone_icon' | 'phone_letter' | 'phone_letter_alt': Choose the icon associated with the phone number.<note><strong>mobile_icon</strong>: Mobile phone icon.</note><note><strong>mobile_letter</strong>: Mobile phone letter M.</note><note><strong>none</strong>: No icon.</note><note><strong>phone_icon</strong>: Phone icon.</note><note><strong>phone_letter</strong>: Phone letter T.</note><note><strong>phone_letter_alt</strong>: Fixed phone letter F.</note>
        - `value` string: The phone number
    - `professional` object
      - `accountName` string
      - `accountNameMode` 'auto' | 'static': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>auto</strong>: The value of the attributes is automatically derived from the user's information.</note><note><strong>static</strong>: The value is predefined in the model and remains constant.</note>
      - `additionalAddress` string
      - `address` string
      - `addressMode` 'auto' | 'static': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>auto</strong>: The value of the attributes is automatically derived from the user's information.</note><note><strong>static</strong>: The value is predefined in the model and remains constant.</note>
      - `addressUrl` string
      - `city` string
      - `country` string
      - `url` string
      - `urlMode` 'auto' | 'static': Specifies the mode for injecting attribute values into the signature template when it is used by a user. The mode determines how the attribute values are provided or derived.<note><strong>auto</strong>: The value of the attributes is automatically derived from the user's information.</note><note><strong>static</strong>: The value is predefined in the model and remains constant.</note>
      - `zipCode` string
  - `fullname` string
  - `has_infomaniak_footer` boolean
  - `is_default` boolean
  - `name` string: Name of the resource `{name}`
  - `position` 'bottom' | 'top': Specifies the position of the signature in an email. The signature can be placed either at the top or at the bottom of the email content.<note><strong>bottom</strong>: The signature is placed at the bottom of the email.</note><note><strong>top</strong>: The signature is placed at the top of the email.</note>
  - `reply_email` string, nullable
  - `sending_email` string, nullable
  - `template_id` string, nullable

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required: Result of the HTTP request
  - `data` boolean

## Other responses

- `500`: Internal Server Error

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) - [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) - [OpenAPI document](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/revisions/96ca7c8a0545?raw)