Back

API Documentation

Integrate dōki monitoring into your applications

Authentication

All API requests require authentication using your API key.

Authorization: Bearer YOUR_API_KEY

Settings

Base URL

https://api.doki.app/v1

Endpoints

GET/monitors

List all monitors

Response

{
  "data": [
    {
      "id": "uuid",
      "name": "My Website",
      "url": "https://example.com",
      "status": "up",
      "uptime_percentage": 99.95,
      "average_response_time": 245
    }
  ]
}
POST/monitors

Create a monitor

Request Body

{
  "name": "My Website",
  "url": "https://example.com",
  "type": "https",
  "interval": 60,
  "timeout": 30
}

Response

{
  "data": {
    "id": "uuid",
    "name": "My Website",
    "url": "https://example.com",
    "status": "pending"
  }
}
GET/monitors/:id

Get a monitor

Response

{
  "data": {
    "id": "uuid",
    "name": "My Website",
    "url": "https://example.com",
    "status": "up",
    "uptime_percentage": 99.95,
    "average_response_time": 245,
    "last_checked_at": "2026-01-12T10:30:00Z"
  }
}
PATCH/monitors/:id

Update a monitor

Request Body

{
  "name": "Updated Name",
  "interval": 120
}

Response

{
  "data": {
    "id": "uuid",
    "name": "Updated Name",
    "interval": 120
  }
}
DELETE/monitors/:id

Delete a monitor

Response

{
  "success": true
}

Rate Limits

API requests are limited to 100 requests per minute per API key.

  • Free100 requests/hour
  • Pro1,000 requests/hour
  • EnterpriseUnlimited