---
title: "Update a signature"
method: PATCH
path: "/v1/users/me/signatures/{id}"
tags: ["Signatures"]
---

# Update a signature

`PATCH /v1/users/me/signatures/{id}`

## Request

- Base URL: `https://api.signvoy.com`
- URL: `https://api.signvoy.com/v1/users/me/signatures/{id}`
- Auth: HTTP bearer

Promotes it to default, replaces its image, or both. `isDefault: false` is a no-op — a user who owns signatures always has exactly one default, so the way to move it is to promote another. Replacing the image leaves already-signed documents untouched, since the image is copied into each submission at signing time.

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateUserSignatureDto
  - `isDefault` boolean: Pass true to make this the default. Passing false is a no-op: a user always has a default while they have any signatures.
  - `source` 'draw' | 'type': How the replacement image was produced. Required with dataUrl.
  - `dataUrl` string: Replacement image as a base64 PNG data URL. Required with source.
  - `typedName` string: The name that was typed. Required when source is 'type'.
  - `fontKey` 'caveat' | 'dancing-script' | 'sacramento' | 'great-vibes' | 'homemade-apple' | 'allura' | 'parisienne': Font the name was rendered in. Required when source is 'type'.

## Response `200`

- UserSignatureDto
  - `id` string, uuid, required
  - `source` 'draw' | 'type', required: How the signature was produced
  - `dataUrl` string, required: The signature image as a base64 PNG data URL
  - `typedName` string, nullable, required: The name that was typed. Only set when source is 'type'.
  - `fontKey` string, nullable, required: Font the name was rendered in, keyed to SIGNATURE_FONTS. Only set when source is 'type'.
  - `isDefault` boolean, required: Offered first when signing. At most one per user.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `404`: Signature not found

---

[API](https://skmtc.dev/signvoy/apis/signvoy-api.md) · [All operations](https://skmtc.dev/signvoy/apis/signvoy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signvoy/apis/signvoy-api/revisions/003cabc7cfe2?raw)