Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dragdropdo.com/llms.txt

Use this file to discover all available pages before exploring further.

  1. Generate an API key.
  2. Upload a file (initiate-upload → presigned PUT → complete-upload).
  3. Create an operation.
  4. Poll for status.

​
1. Get an API key

API keys are managed through the D3 dashboard. To generate an API key:
  1. Sign in to your account at dragdropdo.com/auth/signin
  2. Navigate to your Account section
  3. Go to the Generate API Key section
  4. Create a new API key with a descriptive name
  5. Copy and securely store your API key – it is only shown once
Once you have your API key, you can use it to initialize the client: 
import { Dragdropdo } from "dragdropdo-sdk";

const client = new Dragdropdo({
apiKey: "d3_live_xxx", // Your API key from the dashboard
baseURL: "https://api.dragdropdo.com",
});
Store your api_key securely – it is only shown once in the dashboard. Authentication for /api/v1 endpoints uses this raw key.

​
2. Upload a file

Uploads use presigned URLs. The flow is: POST /api/v1/initiate-upload (get file_key, object_name, upload_id, and presigned URLs) → HTTP PUT each file part to its URL (collect the ETag from each response) → POST /api/v1/complete-upload to finalize the multipart upload and register the file for operations. The complete-upload request body includes file_key, object_name, upload_id, and parts (each part’s etag and part_number); the JSON response includes message and file_key. See Upload → Complete upload for the full request and response schema, authentication, and ETag handling. Official SDKs perform all of these steps when you call uploadFile / upload_file. 
# Step 1: Initiate upload
curl -X POST https://api.dragdropdo.com/api/v1/initiate-upload \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "document.pdf",
    "size": 1234567,
    "mime_type": "application/pdf",
    "parts": 1
  }'

# Step 2: Upload to presigned URL (use ETag from response headers in step 3)

curl -X PUT "https://minio/..." \
 -H "Content-Type: application/pdf" \
 --data-binary "@document.pdf"

# Step 3: Complete upload — required to finalize the upload and obtain a usable file_key

curl -X POST https://api.dragdropdo.com/api/v1/complete-upload \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_key": "file_key_123",
    "object_name": "external/...",
    "upload_id": "upload-id-from-initiate-response",
    "parts": [
      { "etag": "etag-from-put-response", "part_number": 1 }
    ]
  }'

​
3. Create an operation

curl -X POST https://api.dragdropdo.com/api/v1/do \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "convert",
    "file_keys": ["file_key_123"],
    "parameters": {
      "convert_to": "png"
    },
    "notes": {
      "user_id": "user-123",
      "source": "api"
    }
  }'
Response: 
{
  "main_task_id": "task_abc123"
}

​
4. Poll for status

# Single status check
curl -X GET https://api.dragdropdo.com/api/v1/status/task_abc123 \
  -H "Authorization: Bearer your-api-key"

# Poll in a loop (bash example)

while true; do
response=$(curl -s -X GET https://api.dragdropdo.com/api/v1/status/task_abc123 \
 -H "Authorization: Bearer your-api-key")

status=$(echo $response | jq -r '.operation_status')
echo "Status: $status"

if [ "$status" = "completed" ] || [ "$status" = "failed" ]; then
echo $response | jq '.'
break
fi

sleep 2
done
Response: 
{
  "operation_status": "completed",
  "files_data": [
    {
      "file_key": "file_key_123_result",
      "status": "completed",
      "download_link": "/v1/download/file_key_123_result"
    }
  ]
}
For production integrations we recommend configuring webhooks instead of / in addition to polling. See Business API → Webhooks.