Instance Templates

Create reusable templates for common instance configurations. Templates store provider, region, instance type, and other settings so you can provision instances quickly.

List Templates

GET /v1/templates

curl https://api.fugoku.com/v1/templates \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"

Response:

{
  "data": [
    {
      "id": "tpl-abc123",
      "type": "instance-templates",
      "attributes": {
        "name": "gpu-training-base",
        "providerId": "prov-lat-1",
        "region": "lagos-1",
        "instanceType": "gpu-a100-1",
        "image": "ubuntu-22.04-cuda",
        "diskSizeGb": 200,
        "sshKeyId": "ssh-abc123",
        "accelerators": "A100",
        "workerCount": 1,
        "spot": false,
        "tags": { "team": "ml" },
        "createdAt": "2026-08-01T00:00:00Z"
      }
    }
  ]
}

Get Template

GET /v1/templates/:id

curl https://api.fugoku.com/v1/templates/tpl-abc123 \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"

Create Template

POST /v1/templates

Request Body:

Field	Type	Required	Description
`name`	string	Yes	Template name (1–64 chars)
`providerId`	string	Yes	Provider ID
`region`	string	Yes	Region identifier
`instanceType`	string	Yes	Instance type (e.g. `gpu-a100-1`)
`image`	string	No	OS image name
`diskSizeGb`	integer	No	Disk size in GB
`sshKeyId`	string	No	SSH key ID to inject
`accelerators`	string	No	GPU accelerator type
`workerCount`	integer	No	Number of workers (default 1)
`spot`	boolean	No	Use spot pricing (default false)
`tags`	object	No	Resource tags

curl -X POST https://api.fugoku.com/v1/templates \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "gpu-training-base",
    "providerId": "prov-lat-1",
    "region": "lagos-1",
    "instanceType": "gpu-a100-1",
    "image": "ubuntu-22.04-cuda",
    "diskSizeGb": 200
  }'

Response (201):

{
  "data": {
    "id": "tpl-abc123",
    "type": "instance-templates",
    "attributes": {
      "name": "gpu-training-base",
      "providerId": "prov-lat-1",
      "region": "lagos-1",
      "instanceType": "gpu-a100-1"
    }
  }
}

Delete Template

DELETE /v1/templates/:id

Returns 204 No Content.

curl -X DELETE https://api.fugoku.com/v1/templates/tpl-abc123 \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"

Instance Templates

Instance Templates

List Templates

Get Template

Create Template

Delete Template

On this page