Kovadocs

API Overview

Programmatic access to Kova network via REST API.

Base URL

https://app.kovanetwork.com/api/v1/

Endpoint Categories

EndpointDescription
/deploymentsCreate, list, manage, and monitor deployments
/jobsSubmit and track one-time computational jobs
/providerProvider-specific endpoints (bids, leases, earnings)
/nodesQuery network nodes and their availability
/authAuthentication and token management

Authentication

All API requests require bearer token in authorization header:

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  https://app.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

CodeDescription
400 Bad RequestInvalid input, check error.message for details
401 UnauthorizedMissing or invalid auth token
403 ForbiddenAuthenticated but not authorized (wrong user/role)
404 Not FoundResource doesn't exist
500 Internal ErrorServer 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