Skip to content

Errors

Placeholder Position Conflict

A place has both a fixed position and a matching placeholder in the document. Keep one: remove the fixed position or rename the placeholder.

What Happened

A place is positioned twice: it has a fixed position in the request, and its place_key also matches a placeholder in the document. A place can have only one position, either fixed or placeholder.

Example response

422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/placeholder-position-conflict",
  "title": "Placeholder Position Conflict",
  "status": 422,
  "detail": "The place with place_key \"client_signs_here\" is defined both as a fixed position and as a placeholder within the document. Please ensure that each place has only one position, either fixed or placeholder."
}

How to Fix

  • Remove the fixed_positions entry for that place_key to position the place with the placeholder in the document.
  • Alternatively, keep the fixed position and remove or rename the placeholder in the document so its text no longer matches the place_key.
  • Check the detail property in the error response, which identifies the place_key to fix.

  Still stuck? Contact support.