Skip to main content

Getting Started with StateCore Cloud

StateCore Cloud is the managed version of the StateCore open-source memory engine. You get the full /v1 API surface — scopes, memory events, retrieval, reminders — behind a secure API-key gateway, with no infrastructure to run.

This guide walks you from zero to your first successful API call in under 5 minutes.

Step 1 — Create an account​

Sign up at console.statecore.io (or your self-hosted gateway URL):

curl -s -X POST https://api.statecore.io/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "yourpassword"}'

Response

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "email": "you@example.com",
  "createdAt": "2026-06-22T00:00:00.000Z"
}

Step 2 — Log in and get a JWT​

curl -s -X POST https://api.statecore.io/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "yourpassword"}'

Response

{
  "access_token": "eyJhbGci..."
}

Keep the access_token — you need it to manage your API keys.

Step 3 — Create an API key​

Pass your JWT in the Authorization header:

curl -s -X POST https://api.statecore.io/keys \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGci..." \
  -d '{"name": "my-agent"}'

Response

{
  "id": "ck_7a2b3c...",
  "name": "my-agent",
  "key": "sc_live_AbCdEfGhIjKlMnOpQrStUvWxYz...",
  "createdAt": "2026-06-22T00:00:00.000Z"
}
The key is shown once

Copy key now — it is hashed on our side and cannot be retrieved again. If you lose it, revoke it and create a new one.

Step 4 — Call the API​

Use the sc_live_ key as a bearer token in the Authorization header for every /v1 request:

curl -s https://api.statecore.io/v1/health \
  -H "Authorization: Bearer sc_live_AbCdEfGhIjKlMnOpQrStUvWxYz..."

Response

{
  "status": "ok",
  "featureLlm": true
}

You are ready to go. Next, explore:

Base URL​

All /v1 requests go to the same gateway host:

EnvironmentBase URL
Cloud (managed)https://api.statecore.io
Self-hostedhttp://localhost:3001 (gateway default)