{ "info": { "name": "Gigahost API", "_postman_id": "gigahost-api-v0", "description": "Programmatic access to the Gigahost panel.\n\nSet the **username** and **password** collection variables, run the **Authentication \u2192 Authenticate** request once \u2014 its test script stores the bearer token in the `{{token}}` variable. Every other request inherits Bearer-token auth from the collection.\n\nDocs: https://doks.gigahost.no/api/", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "variable": [ { "key": "base_url", "value": "https://api.gigahost.no/api/v0", "type": "string" }, { "key": "username", "value": "you@example.com", "type": "string" }, { "key": "password", "value": "", "type": "string" }, { "key": "token", "value": "", "type": "string" }, { "key": "server_id", "value": "0", "type": "string" }, { "key": "zone_id", "value": "0", "type": "string" }, { "key": "asn_id", "value": "0", "type": "string" }, { "key": "hosting_id", "value": "0", "type": "string" } ], "item": [ { "name": "Authentication", "description": "Bearer-token authentication.", "item": [ { "name": "Authenticate", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/authenticate", "host": [ "{{base_url}}" ], "path": [ "authenticate" ] }, "description": "Sign in and receive a bearer token. The test script saves the token into the `{{token}}` variable.", "body": { "mode": "raw", "raw": "{\n \"username\": \"{{username}}\",\n \"password\": \"{{password}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var json = pm.response.json();", "if (json && json.data && json.data.token) {", " pm.collectionVariables.set('token', json.data.token);", " console.log('Token stored. Expires:', json.data.token_expire);", "} else {", " console.warn('No token in response');", "}" ] } } ] }, { "name": "Authenticate (with 2FA)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/authenticate", "host": [ "{{base_url}}" ], "path": [ "authenticate" ] }, "description": "2FA-enabled accounts: pass the current TOTP code in the `code` field.", "body": { "mode": "raw", "raw": "{\n \"username\": \"{{username}}\",\n \"password\": \"{{password}}\",\n \"code\": 123456\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } } }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/logout", "host": [ "{{base_url}}" ], "path": [ "logout" ] }, "description": "Invalidate the current bearer token." } } ] }, { "name": "Account", "item": [ { "name": "Get account", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/account", "host": [ "{{base_url}}" ], "path": [ "account" ] }, "description": "Customer profile, notification settings, SSH keys and passkeys. Admin contacts also get contacts and orders." } }, { "name": "List invoices", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/billing", "host": [ "{{base_url}}" ], "path": [ "billing" ] }, "description": "Invoices, orders, payment method, cards on file and account credit." } }, { "name": "Dashboard", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dashboard", "host": [ "{{base_url}}" ], "path": [ "dashboard" ] }, "description": "Service counts, outstanding and overdue amounts per currency, and the support PIN." } }, { "name": "Add SSH key", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/account/sshkey", "host": [ "{{base_url}}" ], "path": [ "account", "sshkey" ] }, "description": "Name: 1-64 letters, digits, spaces or - _ . @", "body": { "mode": "raw", "raw": "{\n \"name\": \"laptop\",\n \"data\": \"ssh-ed25519 AAAA... you@laptop\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Rename SSH key", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/account/sshkey/{key_id}", "host": [ "{{base_url}}" ], "path": [ "account", "sshkey", "{key_id}" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"name\": \"laptop 2026\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete SSH key", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/account/sshkey/{key_id}", "host": [ "{{base_url}}" ], "path": [ "account", "sshkey", "{key_id}" ] }, "description": "" } }, { "name": "Preview billing term change", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/account/order/{order_number}/billing?cycle=12", "host": [ "{{base_url}}" ], "path": [ "account", "order", "{order_number}", "billing" ], "query": [ { "key": "cycle", "value": "12" } ] }, "description": "Admin logins only. cycle is 1, 3, 6 or 12 months." } }, { "name": "Change billing term", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/account/order/{order_number}/billing", "host": [ "{{base_url}}" ], "path": [ "account", "order", "{order_number}", "billing" ] }, "description": "Admin logins only. Nothing can be moved to hourly billing.", "body": { "mode": "raw", "raw": "{\n \"billing_cycle\": 12\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Deploy", "item": [ { "name": "Catalogue", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/deploy/servers", "host": [ "{{base_url}}" ], "path": [ "deploy", "servers" ] }, "description": "Products with prices, stock per datacenter (dc_stock), regions, datacenters and payment eligibility." } }, { "name": "Deploy server", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/deploy/servers", "host": [ "{{base_url}}" ], "path": [ "deploy", "servers" ] }, "description": "Places a real order. Use dc_id or region_id. os_id can be an operating system or a one-click app (with optional app_domain and app_email).", "body": { "mode": "raw", "raw": "{\n \"pid\": 0,\n \"price_id\": 0,\n \"dc_id\": 0,\n \"os_id\": 0,\n \"billing_period\": \"monthly\",\n \"hostnames\": [\n \"web-01.example.com\"\n ],\n \"ssh_keys\": []\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Deploy status", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/deploy/status?ids={order_id}", "host": [ "{{base_url}}" ], "path": [ "deploy", "status" ], "query": [ { "key": "ids", "value": "{order_id}" } ] }, "description": "Comma-separated order_ids from the deploy response." } } ] }, { "name": "Servers", "item": [ { "name": "List servers", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers", "host": [ "{{base_url}}" ], "path": [ "servers" ] }, "description": "" } }, { "name": "Get server", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}" ] }, "description": "" } }, { "name": "Rename server", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/name", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "name" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"name\": \"my-renamed-server\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Power on", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/on", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "on" ] }, "description": "" } }, { "name": "Power off", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/off", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "off" ] }, "description": "" } }, { "name": "Reboot", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/reboot", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "reboot" ] }, "description": "" } }, { "name": "Power state", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/powerstate", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "powerstate" ] }, "description": "" } }, { "name": "Start IPMI session (dedicated)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/ipmi", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "ipmi" ] }, "description": "Provision a temporary IPMI session. ACL is semicolon-separated IPs or CIDRs.", "body": { "mode": "raw", "raw": "{\n \"acl\": \"203.0.113.10;198.51.100.0/24\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List snapshots", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/snapshots", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "snapshots" ] }, "description": "" } }, { "name": "Create snapshot", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/snapshot", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "snapshot" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"name\": \"pre-upgrade\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete snapshot", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/snapshot/{snap_id}", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "snapshot", "{snap_id}" ] }, "description": "" } }, { "name": "Bandwidth graph (base64 PNG)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/graphs/port_bits", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "graphs", "port_bits" ] }, "description": "Type is one of port_bits, port_percent, port_errors or port_upkts. Returns graph_day, graph_week, graph_month and graph_year." } }, { "name": "Packet graph (base64 PNG)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/graphs/port_upkts", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "graphs", "port_upkts" ] }, "description": "" } }, { "name": "Set reverse DNS (IPv4)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/reverse", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "reverse" ] }, "description": "v4v6 is `ipv4` or `ipv6` (the IPv6 address that belongs to the IPv4 ip_id).", "body": { "mode": "raw", "raw": "{\n \"ip_id\": 0,\n \"v4v6\": \"ipv4\",\n \"dns\": \"host.example.com\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Set reverse DNS (IPv6 NS delegation)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/reverse", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "reverse" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"sub_id\": 0,\n \"dns\": \"ns1.gigahost.no\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List ISOs", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/isos", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "isos" ] }, "description": "" } }, { "name": "Fetch ISO by URL", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/iso", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "iso" ] }, "description": "At most 3 ISOs per account. The URL must point to a public address.", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://example.com/image.iso\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Mount ISO", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/mount", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "mount" ] }, "description": "Mounts the ISO and reboots the server from it.", "body": { "mode": "raw", "raw": "{\n \"iso_id\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Dismount ISO", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/dismount", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "dismount" ] }, "description": "" } }, { "name": "Delete ISO", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/iso/{iso_id}", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "iso", "{iso_id}" ] }, "description": "" } }, { "name": "List upgrade packages", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/upgrade", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "upgrade" ] }, "description": "" } }, { "name": "Upgrade server", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/upgrade", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "upgrade" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"product_id\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Order additional IP", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/ipv4", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "ipv4" ] }, "description": "num_ips is the number of addresses to order. ip_type is `l2` (layer 2, non-routed) or `l3` (layer 3, routed).", "body": { "mode": "raw", "raw": "{\n \"num_ips\": 1,\n \"ip_type\": \"l2\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Server installation", "item": [ { "name": "List distributions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/reinstall/distro", "host": [ "{{base_url}}" ], "path": [ "reinstall", "distro" ] }, "description": "" } }, { "name": "List OS releases for distro", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/reinstall/distro/{distro_id}", "host": [ "{{base_url}}" ], "path": [ "reinstall", "distro", "{distro_id}" ] }, "description": "" } }, { "name": "List one-click apps", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/reinstall/apps", "host": [ "{{base_url}}" ], "path": [ "reinstall", "apps" ] }, "description": "Pass an app's os_id to reinstall or deploy like an operating system." } }, { "name": "Reinstall server", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/reinstall", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "reinstall" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"os_id\": 0,\n \"language\": \"en_US\",\n \"keyboard\": \"no\",\n \"timezone\": \"Europe/Oslo\",\n \"hostname\": \"myserver.example.com\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Install progress", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/install", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "install" ] }, "description": "404 when the server is not being installed." } }, { "name": "One-click app status", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/servers/{{server_id}}/app", "host": [ "{{base_url}}" ], "path": [ "servers", "{{server_id}}", "app" ] }, "description": "" } } ] }, { "name": "DNS \u2014 zones and records", "item": [ { "name": "List zones", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones", "host": [ "{{base_url}}" ], "path": [ "dns", "zones" ] }, "description": "" } }, { "name": "Create zone", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones", "host": [ "{{base_url}}" ], "path": [ "dns", "zones" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"zone_name\": \"example.com\",\n \"zone_type\": \"NATIVE\",\n \"create_default_records\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete zone", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}" ] }, "description": "" } }, { "name": "List records in a zone", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/records", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "records" ] }, "description": "" } }, { "name": "Create record", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/records", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "records" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"record_name\": \"www\",\n \"record_type\": \"A\",\n \"record_value\": \"198.51.100.10\",\n \"record_ttl\": 3600\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update record", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/records/{record_id}", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "records", "{record_id}" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"record_name\": \"www\",\n \"record_type\": \"A\",\n \"record_value\": \"198.51.100.20\",\n \"record_ttl\": 3600\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete record", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/records/{record_id}?name=www&type=A", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "records", "{record_id}" ], "query": [ { "key": "name", "value": "www" }, { "key": "type", "value": "A" } ] }, "description": "" } }, { "name": "Domain availability check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/check/example.no", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "check", "example.no" ] }, "description": "Public. Works for every TLD Gigahost offers.", "auth": { "type": "noauth" } } }, { "name": "TLD pricing", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/pricing", "host": [ "{{base_url}}" ], "path": [ "dns", "pricing" ] }, "description": "Public.", "auth": { "type": "noauth" } } }, { "name": "Organisation lookup (Br\u00f8nn\u00f8ysund)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/lookup/organization/{org_number}", "host": [ "{{base_url}}" ], "path": [ "dns", "lookup", "organization", "{org_number}" ] }, "description": "" } } ] }, { "name": "DNS \u2014 redirects", "item": [ { "name": "List redirects", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/redirect", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "redirect" ] }, "description": "" } }, { "name": "Create redirect", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/redirect", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "redirect" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"source\": \"@\",\n \"target_url\": \"https://www.example.com\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update redirect", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/redirect", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "redirect" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"source\": \"@\",\n \"target_url\": \"https://new.example.com\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete redirect", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/redirect?source=@", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "redirect" ], "query": [ { "key": "source", "value": "@" } ] }, "description": "" } } ] }, { "name": "DNS \u2014 reverse (PTR)", "item": [ { "name": "Create PTR zone (IPv4)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/ptr", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "ptr" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"prefix\": \"198.51.100\",\n \"ip_version\": \"ipv4\",\n \"zone_name\": \"100.51.198.in-addr.arpa\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Create PTR zone (IPv6 /48)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/ptr", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "ptr" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"prefix\": \"2001:db8::\",\n \"ip_version\": \"ipv6\",\n \"zone_name\": \"0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Domains \u2014 registration", "item": [ { "name": "Register (organisation)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/register", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "register" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"domain_name\": \"example.no\",\n \"registrant_type\": \"organization\",\n \"email\": \"registrant@example.com\",\n \"applicant_name\": \"Acme AS\",\n \"org_number\": \"999999999\",\n \"company_name\": \"Acme AS\",\n \"zip_code\": \"0000\",\n \"city\": \"Oslo\",\n \"use_gigahost_ns\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Register (person)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/register", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "register" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"domain_name\": \"example.no\",\n \"registrant_type\": \"person\",\n \"email\": \"registrant@example.com\",\n \"pid\": \"N.PRI.12345678\",\n \"first_name\": \"Ola\",\n \"last_name\": \"Nordmann\",\n \"use_gigahost_ns\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Register (other TLDs)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/register", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "register" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"domain_name\": \"example.com\",\n \"registrant\": {\n \"first_name\": \"Ola\",\n \"last_name\": \"Nordmann\",\n \"org_name\": \"Acme AS\",\n \"address1\": \"1 Example Street\",\n \"city\": \"Oslo\",\n \"postal_code\": \"0000\",\n \"country_code\": \"NO\",\n \"email\": \"registrant@example.com\",\n \"phone\": \"+47.12345678\"\n },\n \"whois_privacy\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Transfer existing zone", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/transfer", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "transfer" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"zone_name\": \"example.no\",\n \"auth_code\": \"AUTH-CODE\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Request Norid one-time token (.no)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/request-token", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "request-token" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"zone_name\": \"example.no\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get registrant", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/registrant", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "registrant" ] }, "description": "" } }, { "name": "Change registrant", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/registrant", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "registrant" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"registrant_type\": \"organization\",\n \"email\": \"new-registrant@example.com\",\n \"applicant_name\": \"Beta AS\",\n \"org_number\": \"999999999\",\n \"company_name\": \"Beta AS\",\n \"zip_code\": \"0000\",\n \"city\": \"Bergen\",\n \"agree_to_terms\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Change registrant email", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/registrant-email", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "registrant-email" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"email\": \"new@example.com\",\n \"enable_protection\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update nameservers", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/nameservers", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "nameservers" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nameservers\": [\n \"ns1.gigahost.no\",\n \"ns2.gigahost.no\"\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Toggle auto-renew", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/auto-renew", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "auto-renew" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"auto_renew\": 1\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Transfer out (.uk IPS tag)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/ips-tag", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "ips-tag" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"tag\": \"NEWREGISTRAR\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Domains \u2014 mass transfer (.no)", "item": [ { "name": "List transfers", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer" ] }, "description": "" } }, { "name": "Start mass transfer (list)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer" ] }, "description": "Up to 200 .no domains.", "body": { "mode": "raw", "raw": "{\n \"switch_ns\": false,\n \"items\": [\n {\n \"zone_name\": \"example.no\",\n \"auth_code\": \"AUTH-CODE\"\n },\n {\n \"zone_name\": \"example2.no\",\n \"request_token\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Read Domeneshop account", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer/domeneshop", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer", "domeneshop" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"api_token\": \"\",\n \"api_secret\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Import from Domeneshop", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer/import", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer", "import" ] }, "description": "import_id is valid for 1 hour.", "body": { "mode": "raw", "raw": "{\n \"import_id\": 0,\n \"zone_names\": [\n \"example.no\"\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Submit one-time codes", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"codes\": [\n {\n \"item_id\": 0,\n \"auth_code\": \"CODE\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Resend one-time code", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer/{item_id}/token", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer", "{item_id}", "token" ] }, "description": "" } }, { "name": "Abort transfer", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/domains/masstransfer/{item_id}", "host": [ "{{base_url}}" ], "path": [ "dns", "domains", "masstransfer", "{item_id}" ] }, "description": "" } } ] }, { "name": "Domains \u2014 DNSSEC", "item": [ { "name": "Get DS records", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/ds-records", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "ds-records" ] }, "description": "" } }, { "name": "Get stored DS records (external NS)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/ds-records/external", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "ds-records", "external" ] }, "description": "" } }, { "name": "Submit DS records (external NS)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/ds-records/external", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "ds-records", "external" ] }, "description": "Add publicKey (Base64) and keyType (257 or 256) where requires_dnskey is true.", "body": { "mode": "raw", "raw": "{\n \"ds_records\": [\n {\n \"keyTag\": 12345,\n \"alg\": 13,\n \"digestType\": 2,\n \"digest\": \"abcd1234...\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Enable / disable DNSSEC", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/zones/{{zone_id}}/dnssec", "host": [ "{{base_url}}" ], "path": [ "dns", "zones", "{{zone_id}}", "dnssec" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"enable\": 1\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "BGP", "item": [ { "name": "Get BGP overview", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/bgp", "host": [ "{{base_url}}" ], "path": [ "bgp" ] }, "description": "" } }, { "name": "Submit ASN", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "url": { "raw": "{{base_url}}/bgp/asn", "host": [ "{{base_url}}" ], "path": [ "bgp", "asn" ] }, "description": "Form-encoded body, not JSON.", "body": { "mode": "urlencoded", "urlencoded": [ { "key": "asn", "value": "AS65000", "type": "text" } ] } } }, { "name": "Create session", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/bgp/{{asn_id}}/session", "host": [ "{{base_url}}" ], "path": [ "bgp", "{{asn_id}}", "session" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"redundant\": 0,\n \"defaultroute\": 0,\n \"ip_id_v4\": 0,\n \"ip_id_v6\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete session", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/bgp/{session_id}/session", "host": [ "{{base_url}}" ], "path": [ "bgp", "{session_id}", "session" ] }, "description": "" } } ] }, { "name": "Webhosting", "item": [ { "name": "Get webhosting account", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/webhosting/{{hosting_id}}", "host": [ "{{base_url}}" ], "path": [ "webhosting", "{{hosting_id}}" ] }, "description": "`domains` lists every domain on the account, primary first." } }, { "name": "Add domain", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/webhosting/{{hosting_id}}/domains", "host": [ "{{base_url}}" ], "path": [ "webhosting", "{{hosting_id}}", "domains" ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"zone_id\": 0,\n \"update_dns\": 1\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Set primary domain", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/webhosting/{{hosting_id}}/domains/{domain}/primary", "host": [ "{{base_url}}" ], "path": [ "webhosting", "{{hosting_id}}", "domains", "{domain}", "primary" ] }, "description": "" } }, { "name": "Remove domain", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/webhosting/{{hosting_id}}/domains/{domain}", "host": [ "{{base_url}}" ], "path": [ "webhosting", "{{hosting_id}}", "domains", "{domain}" ] }, "description": "Deletes the domain's files, mailboxes and subdomains from the server." } }, { "name": "Get PHP version", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/webhosting/{{hosting_id}}/php?domain=example.com", "host": [ "{{base_url}}" ], "path": [ "webhosting", "{{hosting_id}}", "php" ], "query": [ { "key": "domain", "value": "example.com" } ] }, "description": "" } }, { "name": "Set PHP version", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/webhosting/{{hosting_id}}/php?domain=example.com", "host": [ "{{base_url}}" ], "path": [ "webhosting", "{{hosting_id}}", "php" ], "query": [ { "key": "domain", "value": "example.com" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"version\": \"8.3\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Dynamic DNS", "description": "The only endpoint that accepts HTTP Basic Auth (account email + password). A bearer token or API key works too.", "item": [ { "name": "Update host (IPv4 explicit)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/dyndns?hostname=home.example.com&myip=203.0.113.10", "host": [ "{{base_url}}" ], "path": [ "dns", "dyndns" ], "query": [ { "key": "hostname", "value": "home.example.com" }, { "key": "myip", "value": "203.0.113.10" } ] }, "description": "Returns plain text: `good`/`nochg`/etc.", "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{username}}", "type": "string" }, { "key": "password", "value": "{{password}}", "type": "string" } ] } } }, { "name": "Update host (auto-detect IP)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/dyndns?hostname=home.example.com", "host": [ "{{base_url}}" ], "path": [ "dns", "dyndns" ], "query": [ { "key": "hostname", "value": "home.example.com" } ] }, "description": "", "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{username}}", "type": "string" }, { "key": "password", "value": "{{password}}", "type": "string" } ] } } }, { "name": "Update host (IPv6)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/dns/dyndns?hostname=home.example.com&myipv6=2001:db8::1234", "host": [ "{{base_url}}" ], "path": [ "dns", "dyndns" ], "query": [ { "key": "hostname", "value": "home.example.com" }, { "key": "myipv6", "value": "2001:db8::1234" } ] }, "description": "", "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{username}}", "type": "string" }, { "key": "password", "value": "{{password}}", "type": "string" } ] } } } ] } ] }