Skip to main content

API Playground

Test dakkio API endpoints directly from your browser. Enter your credentials and try sending requests!

Getting Started

Don't have credentials yet? Create a free account and generate an API key.

Authentication Endpoints​

Register User​

Create a new user account and organization.

POST/api/auth/register

Register a new user account. Returns a JWT token for subsequent requests.

Authentication

Request Body (JSON)

Login​

Authenticate with email and password.

POST/api/auth/login

Login with your credentials. Returns a JWT token.

Authentication

Request Body (JSON)

Get Current User​

Retrieve your user profile.

GET/api/auth/me

Get the currently authenticated user's profile. Requires JWT token.

Authentication

Bucket Management​

List Buckets​

Get all buckets in your organization.

GET/api/buckets

List all buckets. Requires JWT authentication.

Authentication

Create Bucket​

Create a new data bucket.

POST/api/buckets

Create a new bucket for storing time-series data.

Authentication

Request Body (JSON)

API Key Management​

Get API Key​

Retrieve your organization's API key.

GET/api/apikeys

Get your organization's API key details (key preview only).

Authentication

Generate API Key​

Create or regenerate your organization's API key.

POST/api/apikeys

Generate a new API key. The full key is only shown once!

Authentication

Request Body (JSON)

Data Ingestion​

Ingest Single Data Point​

Send a single time-series data point.

POST/api/data

Ingest a single data point. Requires API key authentication.

Authentication

Request Body (JSON)

Batch Ingest Data​

Send multiple data points at once.

POST/api/data/batch

Batch ingest multiple data points in a single request.

Authentication

Request Body (JSON)

Data Queries​

Query Time-Series Data​

Retrieve time-series data with filters and aggregations.

POST/api/data/query

Query time-series data with filters, aggregations, and time-based grouping.

Authentication

Request Body (JSON)

Data Source Management​

Create Data Source​

Define a new data source in a bucket.

POST/api/datasources

Create a new data source with schema definition.

Authentication

Request Body (JSON)

Alert Rules​

Create Alert Rule​

Set up an alert with natural language query.

POST/api/alerts

Create an alert rule with natural language condition.

Authentication

Request Body (JSON)

Webhooks​

Create Webhook​

Configure a webhook to receive event notifications.

POST/api/webhooks

Create a webhook to receive alerts and data notifications.

Authentication

Request Body (JSON)

Analytics​

Get Overview Analytics​

Dashboard-level analytics and statistics.

GET/api/analytics/overview

Get organization-level analytics including bucket count, data points, active alerts.

Authentication

Tips for Using the Playground​

1. Get Your Credentials​

  • JWT Token: Login via the /api/auth/login endpoint above, or use the dashboard
  • API Key: Generate via the /api/apikeys endpoint or dashboard

2. Use Real IDs​

Replace placeholder IDs with your actual resource IDs:

  • bucketId: Get from /api/buckets
  • dataSourceId: Get from /api/buckets/:id/datasources

3. Test the Flow​

Try this sequence:

  1. Register/Login → Get JWT token
  2. Create bucket → Get bucket ID
  3. Create data source → Get data source ID
  4. Generate API key → Get API key
  5. Ingest data → Send test data
  6. Query data → Retrieve what you sent

4. Error Handling​

If you get errors:

  • 401 Unauthorized: Check your API key or JWT token
  • 404 Not Found: Verify your resource IDs are correct
  • 400 Validation Error: Check request body matches the schema

Need Help?​

Security Note​

warning

This playground sends real requests to the production API. Be careful with:

  • Personal data in request bodies
  • Production API keys
  • Sensitive information

For testing, use a separate development account and test data only.