Get Classifier Upload URL

GET
/api/v1/classify/{classifierId}/get-url

Request a pre-signed URL for uploading files that need to be classified. This endpoint returns both the upload URL and an unclassified file ID that you'll use in the classification request.

Request Parameters

Path Parameters
required
classifierIdstring

The unique identifier of the classifier you created in the platform. You can find this ID in your classifier settings.

Query Parameters
required
filenamestring

The original filename of the document you want to classify. This is used for file type detection and storage organization.

Headers
required
Authorizationstring

Bearer token for authentication. Format: Bearer your-api-token-here

Response

Success Response (200)

Returns a JSON object containing the pre-signed URL and unclassified file ID.

success-response.json

Response Fields

url
string

Pre-signed URL for uploading the file to cloud storage. This URL is temporary and expires after a short period.

unclassifiedFileId
string

Unique identifier for the unclassified file record. Use this ID in the classification request after uploading the file.

Code Examples

get-classifier-upload-url.js

Next Steps

Upload Your File

Use the signed URL to upload your document file using a PUT request.

PUT {signed_url}
Content-Type: application/pdf
Body: {file_data}
Classify the Document

After uploading, use the unclassifiedFileId to classify your document.

Classification Documentation →