Versions

Create a new version

Creates a new version by uploading a PDF file.

post/v1beta/documents/{document_id}/versions

Path parameters

document_idstring required

Document ID to create version for. Pattern: doc_[0-9a-hjkmnp-tv-z]{26}

Response

Success

created_atstring date-time required

Timestamp when version was created.

descriptionstring nullable

Description of changes in this version.

document_idstring required

Parent document ID. Pattern: doc_[0-9a-hjkmnp-tv-z]{26}

idstring required

Unique ID for the version. Pattern: ver_[0-9a-hjkmnp-tv-z]{26}

processing_status'processing' | 'ready' | 'failed' required

titlestring nullable

Optional version title.

urlstring uri required

URL for accessing this version on Factify.

Example response

{
  "created_by": {
    "id": "user_01h2xcejqtf2nbrexx3vqjhp41"
  },
  "document_id": "doc_01h2xcejqtf2nbrexx3vqjhp41",
  "id": "ver_01h2abcd1234efgh5678jkmnpt",
  "title": "Version 2.0",
  "url": "https://app.factify.com/d/01h2xcejqtf2nbrexx3vqjhp41/v/1"
}

Changes

Changed in 2 of the 50 revisions of this API.224

Mar 16, 2026cb42a69ce4652See the full diff
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
Mar 5, 2026a7e69986914e24See the full diff
- ●
  added the new bot enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new user enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added discriminator to response property for the response status
  response-property-discriminator-added
- ○
  removed the service_account enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the user_account enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  the / response's property pattern was changed from ^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$ to ^(user|bot)_[0-9a-hjkmnp-tv-z]{26}$ for the status
  response-property-pattern-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history