Vitals API

Agent connectivity is live.

Vitals now exposes an authenticated API for AI agents, automations, and assistant-driven logging. Use your API key, send an Authorization: Bearer demo-value header, and work against the same Vitals data that powers the dashboard.

Open account Open Vitals

Copy-ready prompt

Drop this into your assistant, swap in your API key, and start with auth verification.

Connect to my SpaceStatic Vitals account at https://www.spacestatic.com using my Clerk user API key as a Bearer token.
Start with GET /api/v1/agent/me to confirm access, then use GET /api/v1/agent/today for the daily snapshot.
For updates, use the /api/v1/agent/nutrition, /weight, /checkins, /supplements, /recipes, /support, or /ingest routes.
Keep writes structured, confirm totals after updates, and work against the same live data shown in the Vitals dashboard.

Quick start

1. Open Account and create your API key in the Clerk profile area.
2. Send requests to https://www.spacestatic.com with Authorization: Bearer demo-value.
3. Start with /api/v1/agent/me, then move to /today or a structured write route.

curl -H "Authorization: Bearer demo-value" https://www.spacestatic.com/api/v1/agent/me

curl -H "Authorization: Bearer demo-value" https://www.spacestatic.com/api/v1/agent/today

What it is for

- Agent-ready meal logging and day summaries
- Weight, check-in, supplement, recipe, and service connectivity
- Batch assistant workflows through /api/v1/agent/ingest
- One API surface behind the live Vitals dashboard

Endpoints

GET

/api/v1/agent/me

Check auth, resolve the connected user, and confirm agent access is working.

GET

/api/v1/agent/today

Load one compact overview across nutrition, weight, check-ins, supplements, recipes, and service tickets.

GET / POST

/api/v1/agent/nutrition

Read a day of nutrition entries and goals, or log structured meal entries through the agent surface.

GET / POST

/api/v1/agent/weight

Read weight history and goals, or log a weight update for a specific date.

GET / POST

/api/v1/agent/checkins

Read today or history, or save a structured daily check-in for mood, energy, sleep, and notes.

GET / POST

/api/v1/agent/supplements

Read the current supplement day view, create stack items, and mark or toggle what was taken.

GET / POST

/api/v1/agent/recipes

List saved recipes or create and update recipe records through the API.

GET / POST

/api/v1/agent/support

Read service tickets or create a new request from an assistant or automation.

POST

/api/v1/agent/ingest

Send a bundle of agent actions in one call for structured multi-step updates.

Example nutrition write

curl -X POST   -H "Authorization: Bearer demo-value"   -H "Content-Type: application/json"   https://www.spacestatic.com/api/v1/agent/nutrition   -d '{
    "action": "add_entry",
    "date": "2026-04-19",
    "entry": {
      "food": "Turkey sandwich and chips",
      "calories": 680,
      "protein": 32,
      "carbs": 66,
      "fat": 28
    }
  }'

Example batch ingest

curl -X POST   -H "Authorization: Bearer demo-value"   -H "Content-Type: application/json"   https://www.spacestatic.com/api/v1/agent/ingest   -d '{
    "actions": [
      {
        "type": "nutrition.add_entry",
        "date": "2026-04-19",
        "entry": {
          "food": "Protein shake",
          "calories": 240,
          "protein": 30,
          "carbs": 12,
          "fat": 7
        }
      },
      {
        "type": "checkin.upsert",
        "date": "2026-04-19",
        "mood": 4,
        "energy": 3,
        "sleepQuality": 4,
        "notes": "Felt steady after lunch."
      }
    ]
  }'