API Overview

Programmatic access to Kova network via REST API.

Endpoint Categories

| Endpoint | Description | |----------|-------------| | /deployments | Create, list, manage, and monitor deployments | | /jobs | Submit and track one-time computational jobs | | /provider | Provider-specific endpoints (bids, leases, earnings) | | /nodes | Query network nodes and their availability | | /auth | Authentication and token management |

Authentication

All API requests require bearer token in authorization header:

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  https://test.kovanetwork.com/api/v1/deployments

See Authentication for details on obtaining tokens.

Response Format

All responses are JSON. Successful requests return 200/201.

Error Codes

| Code | Description | |------|-------------| | 400 Bad Request | Invalid input, check error.message for details | | 401 Unauthorized | Missing or invalid auth token | | 403 Forbidden | Authenticated but not authorized (wrong user/role) | | 404 Not Found | Resource doesn't exist | | 500 Internal Error | Server error, check logs or contact support |

Rate Limits

Current limits (subject to change):

• 100 requests per minute per API key
• 1000 requests per hour per API key
• File uploads: max 10MB per file, 100MB total per deployment