API Examples

export TOKEN="<access_token>"
export API="https://api.michelangelo.land/v1"

curl "$API/whoami" -H "Authorization: Bearer $TOKEN"

{
  "user_id": "7b1c3f2e-…",
  "client_id": "a4f2…",
  "scopes": ["email"]
}

curl "$API/projects?limit=10" -H "Authorization: Bearer $TOKEN"

{
  "data": [
    { "id": 3637, "name": "API E2E Test App", "created_at": "2026-07-30T…" }
  ],
  "next_cursor": null
}

curl -X POST "$API/jobs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "prompt",
    "project_id": 3637,
    "input": {
      "prompt": "Add a settings screen with a dark-mode toggle persisted to user preferences"
    }
  }'

{
  "id": "3f8a2c1e-9d4b-4e7a-b2c5-…",
  "type": "prompt",
  "status": "queued",
  "project_id": 3637,
  "created_at": "2026-07-31T…"
}

JOB_ID="3f8a2c1e-9d4b-4e7a-b2c5-…"

sleep_s=2
while true; do
  resp=$(curl -s "$API/jobs/$JOB_ID" -H "Authorization: Bearer $TOKEN")
  status=$(echo "$resp" | jq -r '.status')
  echo "[$(date +%T)] status: $status"
  case "$status" in
    succeeded|failed|canceled)
      echo "$resp" | jq .
      break
      ;;
  esac
  sleep "$sleep_s"
  sleep_s=$(( sleep_s * 2 > 30 ? 30 : sleep_s * 2 ))   # backoff: 2s → 30s max
done

{
  "id": "3f8a2c1e-9d4b-4e7a-b2c5-…",
  "status": "succeeded",
  "result": { "project_id": 3637, "files_saved": 6 }
}

curl "$API/projects/3637" -H "Authorization: Bearer $TOKEN"

{ "code": "invalid_prompt", "message": "…" }

curl -s -X POST "$API/jobs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"prompt","project_id":3637,"input":{"prompt":"asdf"}}' | jq .
# { "code": "invalid_prompt", "message": "…" }

resp=$(curl -s -D - -X POST "$API/jobs" …)
# HTTP/2 429
# retry-after: 1200
# { "code": "rate_limited", "message": "…" }

curl https://api.michelangelo.land/v1/health
# { "status": "ok" }