API overview

The DRAGOPS REST API gives you programmatic access to every feature available in the dashboard. You can create and manage patterns, deploy them, trigger executions, configure webhooks, and more.

Base URL

All API requests use the following base URL:

https://your-domain/api

Replace your-domain with the hostname of your DRAGOPS instance.

Authentication

Most endpoints require a Bearer token in the Authorization header. Obtain a token by calling the login endpoint.

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Public endpoints such as GET /api/auth/providers and webhook ingestion do not require authentication.

Request format

Send request bodies as JSON with the Content-Type: application/json header.

curl -X POST https://your-domain/api/patterns \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Pattern"}'

Response format

Successful responses return JSON with a success flag and a data object:

{
  "success": true,
  "data": { ... },
  "timestamp": "2026-03-05T12:00:00.000Z"
}

List endpoints include a meta object with pagination details:

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 47,
    "totalPages": 3
  }
}

Error format

Error responses include a human-readable message and a machine-readable error code:

{
  "error": "Pattern not found",
  "code": "PATTERN_NOT_FOUND"
}

Some endpoints wrap errors in a structured object:

{
  "success": false,
  "error": {
    "code": "VALIDATION",
    "message": "name is required"
  }
}

HTTP status codes

Rate limiting

Rate limits vary by endpoint category. When you exceed a limit, the API returns a 429 status code. The response headers include Retry-After to indicate when you can retry.

• Authentication endpoints have stricter limits to prevent brute-force attacks.
• Webhook ingestion allows up to 100 requests per minute per IP address.
• General API endpoints have separate limits for read and write operations.

Pagination

List endpoints accept page and limit query parameters:

Resources