API Reference

API Documentation

Complete reference for the Wollnut Labs REST API. Manage GPU instances, billing, and more programmatically.

Base URL

text

https://your-domain.com/api/v1

All API requests require an API key passed via the Authorization header unless marked as public.

bash

curl -H "Authorization: Bearer wn_ak_your_key_here" \
  https://your-domain.com/api/v1/instances

API keys are shown only once at creation. Store them securely. Endpoints marked with a icon require authentication.

All responses follow a consistent JSON format:

json

{
  "success": true,
  "data": { ... }
}

json

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Instance not found"
  }
}

Create, manage, and control GPU instances

List available GPU configurations and pricing

Pre-configured environments for ML workloads

Browse and deploy AI models

Credits, balance, usage, and transactions

Manage SSH keys for instance access

Create and manage API keys for programmatic access

User notifications for instance events and billing alerts

Code	HTTP Status	Description
VALIDATION_ERROR	422	Request body failed validation (Zod). Check error.details for field-level messages.
AUTHENTICATION_ERROR	401	Missing or invalid authentication credentials.
AUTHORIZATION_ERROR	403	Authenticated but not authorized for this resource.
NOT_FOUND	404	The requested resource does not exist.
INSUFFICIENT_CREDITS	402	Not enough credits to perform the operation.
RATE_LIMITED	429	Too many requests. Retry after the rate limit window.
E2E_API_ERROR	502	Upstream E2E Networks API error.
INTERNAL_ERROR	500	Unexpected server error.

Check out the Developer page for quickstart guides and SDK examples.