Quickstart

Create an API key

Open Settings → API keys in the webapp and create a key with spaces:read and documents:write. The secret is shown once; copy it into your secret store.

export ADLASS_API_KEY='adl_live_…'

For development use https://dev.adlass.io/v1, the development webapp and an adl_test_ key. Each environment accepts only its own keys.

List your spaces

curl https://api.adlass.io/v1/spaces \
  -H "Authorization: Bearer $ADLASS_API_KEY"

The response contains items and next_cursor. Pick a space ID for the next step.

Register an upload

Writes need an Idempotency-Key; the SDKs add one automatically.

curl https://api.adlass.io/v1/documents \
  -H "Authorization: Bearer $ADLASS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"space_id":"SPACE_UUID","file_name":"report.pdf","content_type":"application/pdf","file_size":1024}'

Upload the bytes and confirm

Request a presigned URL with GET /documents/{document_id}/upload-url, PUT the file to presigned_url, then call POST /documents/{document_id}/confirm-upload with a new Idempotency-Key. The 202 response carries a Location header that points to the processing job; poll it until the status is COMPLETED.