> ## 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.

# Introduction

> Learn how to start building with Gcore’s REST APIs.

# Gcore API Overview

Gcore is a global edge-cloud and security provider with **210+ Points of Presence on six continents**. Every product you see in the [Gcore Product Documentation](/home) is backed by a public, REST-style API so you can automate everything you do in the Customer Portal — or build entirely new experiences of your own.

## Why build on the API?

* **Automate** routine tasks such as CDN cache purges, DNS record updates, or VM provisioning.
* **Integrate** Gcore services into CI/CD pipelines, Terraform workflows, Kubernetes Operators, or custom back-office tools.
* **Monitor & react** to real-time metrics or events and keep your infrastructure in a desired state.

Whether you’re shipping a simple web app or operating a multi-region SaaS platform, Gcore’s APIs give you the same programmatic control used internally by our portal and SDKs.

## Base URLs by product

| Service                            | Base URL                              |
| ---------------------------------- | ------------------------------------- |
| Identity & Access Management (IAM) | `https://api.gcore.com/iam`           |
| Content Delivery Network (CDN)     | `https://api.gcore.com/cdn`           |
| Managed DNS                        | `https://api.gcore.com/dns`           |
| Cloud, GPU Cloud & AI Inference    | `https://api.gcore.com/cloud`         |
| Object Storage                     | `https://api.gcore.com/storage`       |
| FastEdge (Edge Functions)          | `https://api.gcore.com/fastedge`      |
| Video Streaming                    | `https://api.gcore.com/streaming`     |
| DDoS                               | `https://api.gcore.com/security/iaas` |
| WAAP                               | `https://api.gcore.com/waap`          |

## Authentication

1. Sign in to the **Customer Portal → [API tokens](https://portal.gcore.com/accounts/profile/api-tokens)**.
2. Create a token (optionally set an expiry or rotate it later).
3. Send the token as an *APIKey* in the `Authorization` header:

```http theme={null}
GET https://api.gcore.com/iam/clients/me
Authorization: APIKey <YOUR_TOKEN>
```

The header name is case-insensitive, so `Authorization`, `authorization`, and `AUTHORIZATION` all work identically. The same header works for every product API.

<Warning>Gcore API keys always contain a dollar sign (`$`). When you paste the key directly into a terminal,
escape the dollar sign (`\$`) so your shell doesn't treat it as the start of an environment variable.</Warning>

## Quick start (cURL)

Get detailed information about your account

```bash theme={null}
curl -H "Authorization: APIKey $GCORE_TOKEN" "https://api.gcore.com/iam/clients/me"
```

The command should return `HTTP/1.1 200 OK`.

## Tooling & SDKs

| Tool                   | Install                                                                                                                                                                                           | Notes                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| **Python SDK**         | `pip install gcore`<br />[github.com/G-Core/gcore-python](https://github.com/G-Core/gcore-python)                                                                                                 | Auto-generated from OpenAPI, sync and async support |
| **Go SDK**             | `go get github.com/G-Core/gcore-go`<br />[github.com/G-Core/gcore-go](https://github.com/G-Core/gcore-go)                                                                                         | Idiomatic Go client with context support            |
| **Terraform Provider** | `terraform init` with<br />`required_providers { gcore = { source = "G-Core/gcore" } }`<br />[registry.terraform.io/providers/G-Core/gcore](https://registry.terraform.io/providers/G-Core/gcore) | Manage CDN, DNS, Cloud, WAAP, and more              |

## Support & feedback

* **Production incidents:** check [status.gcore.com](https://status.gcore.com).
* **Developer questions:** create a GitHub Discussion in the relevant SDK repo or email **[support@gcore.com](mailto:support@gcore.com)**.
* **Feature requests / bugs:** check [Gcore Roadmap](https://roadmap.gcore.com/).

## Next steps

1. [Create your first permanent token](/account-settings/api-tokens#create-a-permanent-api-token)
2. Explore the existing SDKs and Terraform provider
3. Jump straight to a [product reference](/api-reference/quick-access)
