The Cloud Disco API

A collection of endpoints I use for basic platform functionality. ⚙️
Part playground 🛝, part plumbing 🔧.

Base URL https://api.clouddisco.com
GET /

You're looking at it! This is the API's documentation page.

GET /echo

Greets a visitor by name and city, and adds them to the visitor log. A little parameter playground.

Query parameters

  • name — string, optional, defaults to Frodo
  • city — string, optional, defaults to The Shire
  • details"true" or "false", optional. When "true", the response includes the raw request event for debugging.

Example request

GET /echo?name=Gandalf&city=Rivendell

Example response

{
  "message": "Wazzup, Gandalf of Rivendell!"
}
GET /healthcheck

Healthcheck for the Cloud Disco API and platform services.

Example response

{
  "status": "ok"
}
POST /notes

Queues a short note for me to read later.

Request body

  • message — string, required, non-empty

Example request

POST /notes
Content-Type: application/json

{
  "message": "Great party last night!"
}

Example response

200 OK
{
  "messageId": "b1946ac9-2..."
}

400 if the body isn't valid JSON, or message is missing.

GET /visitors

Returns the list of recorded visitors from the visitor log.

Example response

{
  "visitors": [ ... ]
}