Getting Started

Uploading a new file to Kontera and processing it as a document is a multi-step process.

1. Get a signed URL to upload the file to
2. Upload the file using a PUT to the signed URL
3. Create a document from your uploaded file

Basic Example

upload-file-and-create-document.js

const fs = require('fs')

const uploadFileResponse = await fetch('https://api.kontera.ch/api/public/v1/documents/file', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN' // Make sure to be authorized
    },
    body: JSON.stringify({
        fileName: 'example.pdf',
        contentType: 'application/pdf'
    })
});

const uploadFileData = await uploadFileResponse.json();
const { signedUrl, signedFileName } = uploadFileData;

// Now you can use the signed URL to upload your file
const uploadResponse = await fetch(signedUrl, {
    method: 'PUT',
    headers: {
        'Content-Type': 'application/pdf'
    },
    body: fs.createReadStream('example.pdf')
});

// After the upload, make sure to create a new document using the signedFileName
const createDocumentResponse = await fetch('https://api.kontera.ch/api/public/v1/documents', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN' // Make sure to be authorized
    },
    body: JSON.stringify({
        signedFileName: signedFileName,
        fileName: 'example.pdf',
        processImmediately: true
    })
});

Upload file

Create document