Agent-native Dilnaka Cloud
REST API
The versioned API is the canonical machine interface and the source of the generated OpenAPI document.
Authentication
Send the one-time service-account credential as an Authorization: Bearer header. Credentials are hashed, can expire, and can be revoked or rotated.
- Base URL: /api/v1
- Schema: /openapi.json
- Content type: application/json
Authorization: Bearer dlk_sa_…
Idempotency-Key: your-stable-operation-key
X-Correlation-ID: optional-trace-idErrors and limits
Errors include code, message, retryable, correlation_id, and safe details. HTTP 429 includes Retry-After. Pagination and bounded limits prevent unbounded agent context.
- AUTH_REQUIRED
- INSUFFICIENT_SCOPE
- RESOURCE_NOT_FOUND
- APPROVAL_REQUIRED
- POLICY_DENIED
- QUOTA_EXCEEDED
- RATE_LIMITED
- TASK_FAILED
Resources
Applications, deployments, databases, domains, mail-domain status, storage, environment-variable names, logs, metrics, health, tasks, usage, quotas, billing summaries, and webhooks are exposed through versioned endpoints. Secret values are write-only.
GET /api/v1/applications
PATCH /api/v1/applications/{application_id}
POST /api/v1/deployments
POST /api/v1/deployments/{deployment_id}/rollback
GET /api/v1/domains
GET /api/v1/storage
GET /api/v1/usage
GET /api/v1/quotas
GET /api/v1/tasks/{task_id}
POST /api/v1/webhooksLogs and diagnosis
Application and deployment logs are redacted, bounded, searchable, severity-filtered, and cursor-paginated. Deployment diagnosis is read-only and returns a summary, probable causes, evidence, and recommended actions.
GET /api/v1/applications/{application_id}/logs?limit=100&severity=error&search=timeout
GET /api/v1/deployments/{deployment_id}/diagnosis