Forms

Create Widgets

This endpoint allows you to add a new widget to the document's default layer.

The id is optional, and will be generated by Document Engine if not provided.

post/api/documents/{documentId}/form-field-widgets

Request

  • Base URL: http://localhost:5000
  • URL: http://localhost:5000/api/documents/{documentId}/form-field-widgets
  • Auth: one of:
    • API key in header Authorization
    • HTTP bearer

Path parameters

documentIdstring required

The document ID

Headers

pspdfkit-pdf-passwordstring

The PDF document password.

The value can be either a plain-text password or a base64 encoded password in a form base64:<encoded-password>. Use the Base64 encoding if your password contains characters that are not allowed in HTTP header or would be otherwise mangled (e.g. trailing or leading spaces)

If the document is password protected, any operations performed on it require supplying a password.

Request body

Example request

{
  "formFieldWidgets": [
    {
      "id": "7KPSXX1NMNJ2WFDKN7BKQK9KZE",
      "content": {
        "bbox": [
          255.10077620466092,
          656.7566095695641,
          145.91672653256705,
          18.390804597701162
        ],
        "action": {
          "relativePath": "/other_document.pdf"
        },
        "id": "01DNEDPQQ22W49KDXRFPG4EPEQ",
        "createdAt": "2019-09-16T15:05:03.712909Z",
        "updatedAt": "2019-09-16T15:05:03.712909Z",
        "customData": {
          "foo": "bar"
        },
        "formFieldName": "First-Name",
        "borderColor": "#ffffff",
        "font": "Helvetica",
        "fontSize": 10,
        "fontColor": "#ffffff",
        "backgroundColor": "#000000"
      }
    }
  ]
}

Response

The widgets have been added to the document.

detailsstring

A text summary of the status of the request

request_idstring
result'partial_failure' | 'success' | 'failure'

If all the items in the batch request were successful, then the status will be a success. A partial_failure will occur if only a few of the items in the batch request succeeded. Failure is when none of the items in the batch succeed.

status200 | 400 | 500

HTTP status code for the request. The status code is 200 if the request was processed. This does not have anything to do with the result - the status code will be 200 even if part of the request failed. In the case of total failures such as malformed JSON, or document not found, this status will be other than 200.

Example response

{
  "details": "Operation was partially successful",
  "failingPaths": [
    {
      "path": "$.property[0]",
      "details": "Missing required property"
    }
  ],
  "data": [
    {
      "id": "7KPSXX1NMNJ2WFDKN7BKQK9KZ"
    },
    {
      "id": "7KPSXX1NMNJ2WFDKN7BKQKMM"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.