Tasket - Elevate Your Productivity

Authentication

To use the tasket API, you'll need to authenticate your requests using an API key. Here's how to get started:

Getting Your API Key

Go to Settings → API Keys (or Security section)
Click "Generate API Key" or "Create New Key"
Give your key a descriptive name (e.g., "Production App" or "Zapier Integration")
Copy the API key immediately - you won't be able to see it again
Store it securely in your application's environment variables

Using Your API Key

Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Security Best Practices: Never expose your API keys in client-side code, public repositories, or share them in screenshots. Use environment variables or secure key management systems. Rotate keys regularly and revoke keys you no longer need.

Base URL

All API requests should be made to the tasket API base URL:

https://api.tasket.co/v1

Note: Replace the base URL with your actual API endpoint. The version (v1) may change as the API evolves, so check the documentation for the latest version.

Endpoints

POST/documents

Upload a new document for processing. The document will be automatically processed and data will be extracted.

curl -X POST https://api.tasket.co/v1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf"

Returns the document ID and processing status. You can poll for completion or use webhooks to be notified when processing is done.

GET/documents

List all documents with optional filtering by status, type, date range, and pagination.

curl https://api.tasket.co/v1/documents?status=done&limit=10 \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns a paginated list of documents with metadata. Use query parameters to filter results.

GET/documents/:id

Get detailed information about a specific document including all extracted data, processing status, and metadata.

Returns complete document details including extracted fields, classification, confidence scores, and links to source files.

POST/search

Perform semantic search across all your documents using natural language queries.

curl -X POST https://api.tasket.co/v1/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "invoices over $1000"}'

Returns relevant documents ranked by relevance. Works just like the search feature in the web interface.

POST/company-ai/chat

Ask questions to Company AI programmatically and get answers with source citations.

Send a message and optional conversation history. Returns AI-generated answer with source document citations, just like the web interface.

Webhooks

Configure webhooks to receive real-time notifications when events occur in tasket. This allows your applications to react automatically to document processing, task creation, and other events.

Setting Up Webhooks

Go to Settings → Webhooks (or API section)
Click "Add Webhook" or "Create Webhook"
Enter your webhook URL (the endpoint that will receive notifications)
Select which events you want to subscribe to
Save the webhook - tasket will send POST requests to your URL when events occur

For detailed webhook setup instructions and available events, see theIntegrations guide.