---
title: "Update signatory"
method: PUT
path: "/documents/{document}/signatories/{signatory}"
tags: ["Document Operations"]
---

# Update signatory

`PUT /documents/{document}/signatories/{signatory}`

<small>Requires an API token with the **Document Manager** role.</small>

Updates the details of a [signatory](/#signatories) on a [document](/#documents).

> **Note:** When updating a signatory who has an existing user in the current fynk account
> (`has_account_user` is `true`), only `party_uuid` and `mobile_phone` can be updated.
> Attempting to update other fields (`first_name`, `last_name`, `title`) will cause
> the request to be rejected with a validation error.

## Path parameters

- `document` string, required
- `signatory` string, required

## Request body

- UpdateSignatoryRequest — All fields are optional. Only the fields to be updated need to be provided.
  - `party_uuid` string, uuid — UUID of the [party](/#parties) the signatory will be signing for
  - `first_name` string, nullable — Cannot be updated if the signatory's `has_account_user` field is true
  - `last_name` string, nullable — Cannot be updated if the signatory's `has_account_user` field is true
  - `mobile_phone` string, nullable — Mobile phone number, in E.164 format, as shown in the example
  - `title` string, nullable — Cannot be updated if the signatory's `has_account_user` field is true

## Response `200`

`SignatoryResource`

- object
  - `data` SignatoryResource, required
    - `uuid` string, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `email` string, nullable, required
    - `mobile_phone` string, nullable, required — Mobile phone number, in E.164 format
    - `title` string, nullable, required
    - `profile_photo_url` string, nullable, required
    - `signing_order` integer, nullable, required — When sequential signing is enabled, signatories will sign in ascending order of their `signing_order`
    - `has_account_user` boolean, required — `true` if the signatory has a fynk user belonging to your account
    - `party_uuid` string, nullable, required — UUID of the party that the signatory signs for

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `404` — Not found
- `409` — The resource's current state prevents the requested change
- `422` — Validation error

---

[API](https://skmtc.dev/fynk/apis/fynk-api-reference.md) · [All operations](https://skmtc.dev/fynk/apis/fynk-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynk/fynk-api-reference/revisions/9657a6757f59/schema)