Cloud API

Racks

Where servers and runtimes belong: the company’s own machines (`local`), or what Cloud runs in an AWS account or a GCP project — the clouds themselves are connected under Connections.

Base URL https://cloud.yet.com.br/v1

The object

idstring: Its id.
namestring: Its name, up to 60 characters.
kind"local" | "aws" | "gcp": What it is. Only local is open for now.
descriptionstring: What it is for.

List racks

GET/v1/racks

Every rack, with its servers and runtimes.

Request

curl https://cloud.yet.com.br/v1/racks \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 200

[
  {
    "id": "rk_01J9",
    "name": "Home Rack",
    "kind": "local",
    "description": "",
    "servers": [],
    "runtimes": []
  }
]

Create a rack

POST/v1/racks

A new rack.

Who: Cloud admin

Body

namestringrequired: Its name.
kindstringrequired: local, aws or gcp.
descriptionstring: What it is for.

Request

curl -X POST https://cloud.yet.com.br/v1/racks \
  -H "Authorization: Bearer $YET_API_KEY" \
  -d '{
    "name": "Home Rack",
    "kind": "local"
  }'

Response · 201

{
  "id": "rk_01J9",
  "name": "Home Rack",
  "kind": "local",
  "description": "",
  "created_at": "2026-10-23T12:00:00Z"
}

Change a rack

PATCH/v1/racks/{id}

Its name or its description.

Who: Cloud admin

Body

namestring: A new name.
descriptionstring: A new description.

Request

curl -X PATCH https://cloud.yet.com.br/v1/racks/{id} \
  -H "Authorization: Bearer $YET_API_KEY" \
  -d '{
    "description": "The machines in the office."
  }'

Delete a rack

DELETE/v1/racks/{id}

Once nothing is in it.

Who: Cloud admin

Request

curl -X DELETE https://cloud.yet.com.br/v1/racks/{id} \
  -H "Authorization: Bearer $YET_API_KEY"

Response · 204 No Content