Update a Project Signer

Update the details of a signer associated with a specific project in the ENTERPRISE API. This endpoint allows you to modify signer information such as name, signing order, and role within a project.

HTTP Method & URL

• Method: PUT

• URL: {{host}}/projects/:uuid/signers/:signerId?user_type=ENTERPRISE_API

Authentication

• Type: Bearer Token (recommended)

• Header: Authorization: Bearer {USER-TOKEN}

Path Parameters

Query Parameters

Request Body

Send a raw JSON object with the following fields:

Example Request Body:

{
  "first_name": "John",
  "last_name": "Doe",
  "sequence": 1,
  "signer_role": "Signer"
}

Example Request

PUT {{host}}/projects/{{project-uuid}}/signers/{{signerId}}?user_type=ENTERPRISE_API
Authorization: Bearer {USER-TOKEN}
Content-Type: application/json
{
  "first_name": "John",
  "last_name": "Doe",
  "sequence": 1,
  "signer_role": "Signer"
}

Example Successful Response

{
  "id": "{{signerId}}",
  "first_name": "John",
  "last_name": "Doe",
  "sequence": 1,
  "signer_role": "Signer",
  "status": "updated"
}

Error Responses

Usage Notes

• Ensure the user_type query parameter is always set to ENTERPRISE_API.

• The sequence field determines the order in which signers are required to sign (must be unique per project and between 1-10).

• Only users with appropriate permissions can update signer details.

• All fields in the request body are required.

• Use environment variables (e.g., {{host}}, {{project-uuid}}, {{signerId}}) for flexibility across environments.