turknode.cloud/docs/api

API

Every action in the panel has an endpoint. Create a token, send JSON, get JSON back.

Basics

Base URL: https://api.turknode.cloud/v1
Auth: Authorization: Bearer YOUR_TOKEN — create tokens in the panel under Developer → API Keys
Tokens: Up to 10 per account, revocable at any time
Rate limit: 120 requests a minute per account
Billing: Servers ordered through the API are paid from your wallet
Headers: Send Accept: application/json and your own User-Agent

List plans

Use a plan id when you order.

curl https://api.turknode.cloud/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "User-Agent: my-app/1.0"

Create a server

The root password must be 8–12 characters with a lowercase letter, an uppercase letter, a digit and one of ! # + $ * -.

curl -X POST https://api.turknode.cloud/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "User-Agent: my-app/1.0" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

Endpoints

Account and catalog

GET	/v1/account	Your account, balance and reseller discount
GET	/v1/plans	Plans on sale, with prices
GET	/v1/os	Operating systems you can install

Servers

GET	/v1/servers	List your servers
POST	/v1/servers	Create a server
GET	/v1/servers/{id}	Server details
PATCH	/v1/servers/{id}	Rename a server
DELETE	/v1/servers/{id}	Cancel a server; unused time returns to the wallet
POST	/v1/servers/{id}/start	Start
POST	/v1/servers/{id}/stop	Stop
POST	/v1/servers/{id}/restart	Restart
POST	/v1/servers/{id}/rebuild	Reinstall with another system
POST	/v1/servers/{id}/reset-password	Set a new root password
POST	/v1/servers/{id}/request-ip-change	Ask for an IP replacement
GET	/v1/servers/{id}/upgrade-options	Plans this server can move up to
POST	/v1/servers/{id}/upgrade	Upgrade to a bigger plan
POST	/v1/servers/{id}/vnc	Open a browser console session

Wallet and invoices

GET	/v1/wallet	Wallet balance
GET	/v1/wallet/transactions	Wallet transactions
GET	/v1/invoices	List invoices
GET	/v1/invoices/{id}	Invoice details

Support tickets

GET	/v1/tickets	List tickets
POST	/v1/tickets	Open a ticket
GET	/v1/tickets/{id}	A ticket with its messages
POST	/v1/tickets/{id}/reply	Reply to a ticket
POST	/v1/tickets/{id}/close	Close a ticket

Errors

401 Unauthenticated

The token is wrong or was revoked. Create a new one under Developer → API Keys.

403 with error 1010

Your HTTP library sends a default User-Agent that our firewall blocks (Python urllib, Perl LWP). Set your own User-Agent header, or use requests / httpx.

422 Unprocessable

A field is invalid; the JSON body lists each field and why.

429 Too Many Requests

You passed 120 requests a minute. Wait and retry.

Selling from WHMCS?

Our free module uses this API for you.

WHMCS module