Documents

Create a document

Changed on

Creates a new document by uploading a PDF file.

post/v1beta/documents

Request

  • Base URL
    https://api.factify.com
  • URL
    https://api.factify.com/v1beta/documents
  • Auth
    HTTP bearer

Request body multipart/form-data

access_level'private' | 'organization' | 'public'
descriptionstring nullable

Optional document description.

document_idstring

Pre-generated document ID (set by server)

payloadstring binary required

PDF file to upload

payload_keystring

Storage key for uploaded file (set by server)

titlestring required

Document title.

version_idstring

Pre-generated version ID (set by server)

Response

Success

Example response

{
  "document": {
    "created_by": {
      "id": "user_01h2xcejqtf2nbrexx3vqjhp41"
    },
    "current_version": {
      "id": "ver_01h2abcd1234efgh5678jkmnpt"
    },
    "description": "Quarterly financial report for Q4 2024",
    "id": "doc_01h2xcejqtf2nbrexx3vqjhp41",
    "owner_organization_id": "org_01h2xcejqtf2nbrexx3vqjhp41",
    "title": "Q4 2024 Financial Report",
    "url": "https://app.factify.com/d/01h2xcejqtf2nbrexx3vqjhp41"
  }
}

Changes