Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gcore.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.
SDKPackageSourceRequirements
Pythongcore on PyPIgcore-pythonPython 3.9+
Gogithub.com/G-Core/gcore-gogcore-goGo 1.22+

​
Choosing a client

All options call the same API — the choice depends on the context:
SituationRecommendation
Scripting, automation, CI/CDPython SDK or Go SDK
One-off inspection, debuggingcurl or HTTPie
Shell scriptscurl
Production Node.js servicesJavaScript fetch or axios (see below)
Production Python servicesPython SDK (sync or async)
Production Go servicesGo SDK
Terraform-managed infrastructureTerraform 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]);