Life setup save

POST/v1/life/setup

Signed-in sessionLaunch key product.workOperation life_setup_save

Private trackers for hydration, nutrition, fitness, sleep, pets, check-ins and custom measures.

Body

idempotencyKeystringRequired
expectedRevisionnumberRequired
setupobjectRequired

Returns

receiptobjectRequired
snapshotobjectRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.

POST/v1/life/setup

curl "$SPECIFY_API_ORIGIN/v1/life/setup" \
  -X POST \
  -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"retry-1","expectedRevision":1,"setup":{"human":{"label":"<label>"},"pets":[{"key":"<key>","label":"<label>"}],"trackers":[{"key":"<key>","subject":{"kind":"human"},"domain":"checkins","config":{"domain":"fitness","headlineMetric":"distanceM"},"cadence":"as_needed"}]}}'

Response

{
  "result": {
    "receipt": {
      "receiptId": "<receiptId>",
      "targetId": "<targetId>",
      "revision": 1,
      "replayed": true
    },
    "snapshot": {
      "status": "ready",
      "context": {
        "accountId": "<accountId>",
        "serviceTenancyId": "<serviceTenancyId>",
        "authorizationVersion": "<authorizationVersion>"
      },
      "preferences": {
        "timeZone": "<timeZone>",
        "locale": "<locale>",
        "version": 1
      },
      "limits": {
        "activeTrackers": 20,
        "pets": 10,
        "eventsPerBatch": 20,
        "noteMaxLength": 2000,
        "labelMaxLength": 80,
        "keyMaxLength": 64,
        "journalDayDriftDays": 2,
        "futureToleranceMs": 1,
        "earliestObservedAt": 946684800000
      },
      "registryVersion": 1,
      "profile": "<profile>",
      "subjects": [
        {
          "id": "<id>",
          "kind": "human",
          "label": "<label>",
          "species": "<species>",
          "state": "active",
          "revision": 1
        }
      ],
      "trackers": [
        {
          "id": "<id>",
          "subjectId": "<subjectId>",
          "domain": "checkins",
          "registryVersion": 1,
          "config": {
            "domain": "checkins",
            "kind": "energy"
          },
          "displayUnits": {},
          "cadence": "as_needed",
          "state": "active",
          "revision": 1,
          "eventSequence": 1,
          "metrics": [
            {
              "key": "<key>",
              "unit": "<unit>",
              "reduce": "count"
            }
          ]
        }
      ]
    }
  }
}