---
updatedAt: 2026-05-28T15:48:11.000Z
agentTools:
  projectIndex: https://dev.frontapp.com/llms.txt
---

# Update signature

Update signature

Required scope: `signatures:write`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-api-id": "front",
  "x-explorer-enabled": false,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "info": {
    "version": "1.0.0",
    "title": "Core API",
    "contact": {
      "name": "Front Platform",
      "url": "https://community.front.com"
    }
  },
  "security": [
    {
      "http": []
    }
  ],
  "servers": [
    {
      "url": "https://api2.frontapp.com"
    }
  ],
  "components": {
    "schemas": {
      "SignatureResponse": {
        "type": "object",
        "required": [
          "_links",
          "id",
          "name",
          "body",
          "sender_info",
          "is_private",
          "is_visible_for_all_teammate_channels",
          "is_default",
          "channel_ids"
        ],
        "properties": {
          "_links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string",
                "description": "Link to resource",
                "example": "https://yourCompany.api.frontapp.com/signatures/sig_6rrv2"
              },
              "related": {
                "type": "object",
                "properties": {
                  "owner": {
                    "type": "string",
                    "description": "Link to signature's owner (either a team or teammate)",
                    "example": "https://yourCompany.api.frontapp.com/teams/tim_k30"
                  }
                }
              }
            }
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the signature",
            "example": "sig_6rrv2"
          },
          "name": {
            "type": "string",
            "nullable": true,
            "description": "Name of the signature",
            "example": "Finer Things Club signature"
          },
          "body": {
            "type": "string",
            "description": "Body of the signature",
            "example": "<div>—<br />{{user.name}}<br />No paper, no plastic, and no work talk allowed<br /></div>"
          },
          "sender_info": {
            "type": "string",
            "nullable": true,
            "description": "Sender info of the signature",
            "example": "{{user.name}}"
          },
          "is_visible_for_all_teammate_channels": {
            "type": "boolean",
            "description": "Whether or not the signature is available in teammate channels.",
            "example": true
          },
          "is_default": {
            "type": "boolean",
            "description": "Whether the signature is the default signature for the team or teammate.",
            "example": false
          },
          "is_private": {
            "type": "boolean",
            "description": "Whether the signature is private to the teammate.",
            "example": true
          },
          "channel_ids": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string",
              "description": "List of channels the signature is available in. If belonging to a teammate, represents all channels this can be used in. If belonging to a team, represents all team channels this can be used in. If null, there are no restrictions.",
              "example": null
            }
          }
        }
      },
      "UpdateSignature": {
        "type": "object",
        "description": "A signature that can be used to sign messages.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the signature"
          },
          "sender_info": {
            "type": "string",
            "description": "Sender info of the signature that will appear in the From line of emails sent."
          },
          "body": {
            "type": "string",
            "description": "Body of the signature"
          },
          "is_visible_for_all_teammate_channels": {
            "type": "boolean",
            "description": "Whether or not the signature is visible in all individual channels for teammates in the given team. Can only be set for shared signatures."
          },
          "is_default": {
            "type": "boolean",
            "description": "If true, the signature will be set as the default signature for the team or teammate.",
            "default": false
          },
          "channel_ids": {
            "type": "array",
            "description": "The specific shared channels this signature if available in. If null, then it will be available in all channels. If unspecified, will retain previous value. Alternatively, you can specify channels using a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "http": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "responses": {
      "signature": {
        "description": "A signature",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/SignatureResponse"
            }
          }
        }
      }
    }
  },
  "paths": {
    "/signatures/{signature_id}": {
      "patch": {
        "summary": "Update signature",
        "operationId": "update-signature",
        "description": "Update signature\n\nRequired scope: `signatures:write`",
        "tags": [
          "Signatures"
        ],
        "requestBody": {
          "required": true,
          "description": "Signature to update",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSignature"
              }
            }
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "signature_id",
            "required": true,
            "description": "The signature ID",
            "schema": {
              "type": "string",
              "default": "sig_123"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/signature"
          }
        },
        "x-required-scopes": [
          "signatures:write"
        ]
      }
    }
  }
}
```