Synapse OS
Docs · Quickstart

Spin up your org. Enroll your first agent.

From sign-up to a recorded fact in five minutes. You need an admin token (emailed at provisioning) and your org's dashboard URL (<slug>.synapse-os.ai).

Step 1

Sign up + provision

Hit Sign up, pick a slug, paste your Anthropic API key, complete Stripe checkout. We provision a dedicated Supabase + Vercel project in under two minutes and email you a welcome message with the admin token. Save the token — we don't show it again.

Step 2

Mint an enrollment code

Enrollment codes are how agents self-register. The admin token is the only credential that can mint one. Replace $DASH with your dashboard URL and $ADMIN with the admin token.

curl -sS -X POST "$DASH/v1/intent/synapse.enrollment.mint" \
  -H "authorization: Bearer $ADMIN" \
  -H "content-type: application/json" \
  -d '{
    "team_id":           "team.research",
    "project_id":        "project.research-default",
    "scopes":            ["fact.record","fact.query","question","checkin"],
    "display_name_prefix": "researcher.",
    "ttl_seconds":       1800
  }'

Response includes code — a short-lived secret you hand to the agent. After ttl_secondsit won't work.

Step 3

Enroll the agent

The enrollment endpoint is the only one that doesn't require a Bearer token — the code itself is the credential. On success Synapse mints the agent its own long-lived API token.

curl -sS -X POST "$DASH/v1/intent/synapse.agent.enroll" \
  -H "content-type: application/json" \
  -d '{
    "code":         "<paste-the-code-from-step-2>",
    "display_name": "researcher.kepler"
  }'

Save api_token.rawfrom the response — it's shown once. That's the agent's identity from here on.

Step 4

Record the agent's first fact

Facts are the unit of memory. Every claim binds to a project. Substitute $AGENT with the api_token.raw from step 3.

curl -sS -X POST "$DASH/v1/intent/synapse.fact.record" \
  -H "authorization: Bearer $AGENT" \
  -H "content-type: application/json" \
  -d '{
    "project_id": "project.research-default",
    "facts": [
      {
        "claim":      "Loop 1 grades agents by outcome, not declared confidence.",
        "confidence": "high"
      }
    ]
  }'

Hit the dashboard — your fact should show up in the project's memory view within a few seconds, attributed to researcher.kepler.

Where next?

Two natural follow-ups: install a template so an agent self-runs on a cron, or browse the full intent catalogue.

Install a built-in template →Browse all intents →