Gcore API SDKs

Gcore publishes official SDKs for Python and Go, both generated from the OpenAPI specification using Stainless. Method names and parameter names match the API reference exactly.

SDK	Package	Source	Requirements
Python	gcore on PyPI	gcore-python	Python 3.9+
Go	github.com/G-Core/gcore-go	gcore-go	Go 1.22+

Choosing a client

All options call the same API — the choice depends on the context:

Situation	Recommendation
Scripting, automation, CI/CD	Python SDK or Go SDK
One-off inspection, debugging	curl or HTTPie
Shell scripts	curl
Production Node.js services	JavaScript fetch or axios (see below)
Production Python services	Python SDK (sync or async)
Production Go services	Go SDK
Terraform-managed infrastructure	Terraform provider

SDK coverage

The Python and Go SDKs cover the full API surface: Cloud (instances, volumes, networking, Kubernetes, load balancers, and more), IAM, CDN, DNS, Object Storage, FastEdge, Streaming, and WAAP.

All Cloud API endpoints have auto-generated SDK methods. The API reference code samples show the exact method name for each endpoint.

---

JavaScript

No dedicated JavaScript SDK is published. Use the built-in fetch API (Node.js 18+, all modern browsers) or axios.

fetch (Node.js 18+)

const BASE_URL = 'https://api.gcore.com';
const TOKEN = process.env.GCORE_API_KEY;

// GET — verify token
const res = await fetch(`${BASE_URL}/iam/clients/me`, {
  headers: { Authorization: `APIKey ${TOKEN}` },
});
const account = await res.json();
console.log(account.id, account.email);

// POST — create a network
const netRes = await fetch(
  `${BASE_URL}/cloud/v1/networks/${process.env.PROJECT_ID}/${process.env.REGION_ID}`,
  {
    method: 'POST',
    headers: {
      Authorization: `APIKey ${TOKEN}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ name: 'my-network' }),
  }
);
const { tasks } = await netRes.json();
console.log('Task ID:', tasks[0]);

axios

npm install axios

const axios = require('axios');

const client = axios.create({
  baseURL: 'https://api.gcore.com',
  headers: { Authorization: `APIKey ${process.env.GCORE_API_KEY}` },
});

const { data: account } = await client.get('/iam/clients/me');
console.log(account.id, account.email);

const { data } = await client.post(
  `/cloud/v1/networks/${process.env.PROJECT_ID}/${process.env.REGION_ID}`,
  { name: 'my-network' }
);
console.log('Task ID:', data.tasks[0]);

Handle async operations

Cloud API write operations return a task ID. Poll it until state is FINISHED:

async function waitForTask(taskId, intervalMs = 5000) {
  const headers = { Authorization: `APIKey ${process.env.GCORE_API_KEY}` };
  while (true) {
    const res = await fetch(`https://api.gcore.com/cloud/v1/tasks/${taskId}`, { headers });
    const task = await res.json();
    if (task.state === 'FINISHED') return task.created_resources;
    if (task.state === 'ERROR') throw new Error(`Task failed: ${task.error}`);
    await new Promise(r => setTimeout(r, intervalMs));
  }
}

const { tasks } = await netRes.json();
const resources = await waitForTask(tasks[0]);
console.log('Network ID:', resources.networks[0]);