Skip to content
DocSpring Documentation

C# API Client

New versions of the DocSpring C# API client. To install it, see Install an API Client. You can also get these release notes by email.

Changelog

Section titled “Changelog”

3.5.0

Section titled “3.5.0”
Released on Oct 18, 2026
  • Submissions and combined submissions can be in the new insufficient_credits state: a live PDF that your credit balance can’t cover is saved and processed once you add credits. See https://docspring.com/docs/api-guide/credits-and-rate-limits/.
  • generate_pdf, batch_generate_pdfs and combine_pdfs document the 402 response for insufficient credits. Their responses can include a code, which is insufficient_credits on a 402.
  • generate_pdf, batch_generate_pdfs, create_pdf_template, create_pdf_template_from_upload, create_html_template and copy_template document a 403 response with a code of upgrade_required (the plan doesn’t include it) or account_suspended.

3.4.0

Section titled “3.4.0”
Released on Oct 18, 2026
  • Requests no longer throw Nullable object must have a value when they leave out an optional enum, such as a data request’s auth_type or auth_second_factor_type.
  • Templates: new parse_dates_using_template_date_format setting, when you create or update a template. When it’s true, date values sent as NN/NN/YYYY (with slashes, dashes or dots) are read in the order of the template’s default date format: month first for %m/%d/%Y, day first for %d/%m/%Y. When it’s false, they’re read day first.
  • A new README: installing, a quick start, every API method, errors, and how API changes are handled. The repository also has an AGENTS.md for coding agents.

3.3.0

Section titled “3.3.0”
Released on Oct 15, 2026
  • Submissions and data requests can now be in the declined state, when a signer declines to sign. Data requests have a new declined_at timestamp. Earlier versions raise an error when they read a declined submission or data request.
  • New API methods for webhooks: create_webhook, list_webhooks, get_webhook, update_webhook and delete_webhook.
  • New API method: get_template_model_code, which generates typed model code for a template’s submission data, so your app can catch mistakes before it calls the API.
  • Templates:
    • Field dependencies: field_dependencies when you create or update a template, and dependencies on the fields you add with add_fields_to_template.
    • add_fields_to_template accepts the initials field type and an editable setting for each field.
    • Embedded template editor settings: embed_edit_allow_document_replacement, embed_edit_allow_settings, embed_edit_allow_versioning and embed_edit_token.
    • New template_schema_version attribute.
    • A template’s path is never null.
    • Individual template defaults can be null (for example fontSize after it’s cleared in the template editor).
    • last_changed_by_type can be external_user (a change made in the embedded template editor), with last_changed_by_external_id, last_changed_by_external_name and last_changed_by_external_email.
    • Template versions say who published them with published_by_type, published_by_user_id, published_by_name, published_by_email and published_by_external_id. These replace published_by_id, which the API no longer returns.
    • The JSON schema from get_template_schema includes $id, allOf and dependencies.
  • copy_template accepts a template version, and parent_folder_id is now optional. move_template_to_folder also accepts a version.
  • Pass a null parent_folder_id to move_template_to_folder or move_folder_to_folder to move it to the root folder.
  • Submissions and submission actions include an error_message when processing fails.
  • combine_pdfs: delete_custom_files now deletes the custom files once the merged PDF is processed (it used to be ignored). test has no effect and is deprecated.
  • An enum value added to the API after this release (e.g. a new submission state) deserializes as UnknownDefaultOpenApi instead of throwing (or, for an attribute that can be null, instead of null). Enums have the new UnknownDefaultOpenApi member, so an exhaustive switch over one needs a case for it.
  • get_submission, list_submissions and list_template_submissions no longer fail when include_data isn’t set. source, referrer and data are optional on submissions, because the API only returns them with include_data. Submission.source is now nullable.
  • get_template and list_templates no longer fail for a template whose last_changed_by_type is null, and a null enum value serializes as null.
  • The host argument and DOCSPRING_HOST can end with /api/v1/ or have spaces around them (a trailing slash after /api/v1 used to repeat it).

3.2.0

Section titled “3.2.0”
Released on Sep 24, 2025
  • All our API clients are now 100% end-to-end tested against our real server.

3.1.0

Section titled “3.1.0”
Released on Mar 22, 2025
  • Added support for Template Versioning parameters:
    • Optional version parameter in submission requests (e.g., 1.2.3, draft, latest)
    • New API methods: publish_template_version, restore_template_version
    • Updated copy_template and delete_template methods to accept template version strings

3.0.1

Section titled “3.0.1”
Released on Feb 26, 2025
  • Fixed User-Agent header: docspring-csharp-x.x.x

3.0.0

Section titled “3.0.0”
Released on Feb 23, 2025
  • BREAKING CHANGE: Updated default host to our new synchronous API subdomain: sync.api.docspring.com. (EU customers should use sync.api-eu.docspring.com). Removed all custom polling code from library since this logic is now handled by the API service running on our sync subdomain

2.0.0

Section titled “2.0.0”
Released on Jan 30, 2025
  • Initial support for template versioning (before we decided to release the synchronous API first.)

1.4.3

Section titled “1.4.3”
Released on Nov 28, 2021
  • Added ‘password’ parameter to Generate PDF and Combine PDF API endpoints. You can now encrypt each generated PDF with a unique password.

1.4.1

Section titled “1.4.1”
Released on Nov 19, 2020
  • Added “sort_order” property for Submission Data Requests

1.4.0

Section titled “1.4.0”
Released on Sep 26, 2020
  • Updated OpenAPI Generator to v3.3.0

1.3.1

Section titled “1.3.1”
Released on Sep 24, 2020
  • Fixed the “include_data=true” option for the “Get Submission” API endpoint. Added the “data” property to the Submission model so that this is parsed and returned correctly when requested

1.3.0

Section titled “1.3.0”
Released on Sep 21, 2020
  • Renamed some internal models for template creation API endpoints. (CreateTemplateData / CreateTemplateData1 renamed to CreateHtmlTemplateData and CreateTemplateFromUploadData)

1.2.0

Section titled “1.2.0”
Released on Sep 12, 2020
  • BREAKING CHANGE: Renamed createTemplate operation to createPDFTemplate
  • Added createHTMLTemplate operation. (This uses the same API endpoint as createPDFTemplate, but the example shows how to set html, scss, etc. fields)
  • Added updateTemplate operation, to update a PDF or HTML template

1.1.0

Section titled “1.1.0”
Released on Jul 7, 2020
  • Update to use latest API schema

1.0.0

Section titled “1.0.0”
Released on May 20, 2019
  • Renamed FormAPI to DocSpring. (View the CHANGELOG in the original FormAPI API client for prior releases.)