Quickstart

Make a direct Adapt-1 request and use the JSON result in your application. Choose cURL, Python, or JavaScript below; all three send the same request.

Set your API key

Use an Adapt-1 Unit API key, stored in your local environment or server-side secret store:

Environment

export ADAPT1_API_KEY="YOUR_SECRET_TOKEN"

The examples use https://rei-neuroadapt-api.reilabs.org/api/v1. Keep the key out of browser code, source control, and logs.

Make your first call

This request asks the State gateway for available evidence. It is read-only: update_memory_state is explicitly false.

curl -fsS --max-time 60 \
  "https://rei-neuroadapt-api.reilabs.org/api/v1/memory/query" \
  -H "Authorization: Bearer $ADAPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "ignored",
    "user_message": "What operating constraints are available?",
    "top_k": 5,
    "include_reasoning": true,
    "update_memory_state": false
  }'

import json
import os
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen

key = os.environ.get("ADAPT1_API_KEY")
if not key:
    raise SystemExit("Set ADAPT1_API_KEY in your server environment.")

request = Request(
    "https://rei-neuroadapt-api.reilabs.org/api/v1/memory/query",
    data=json.dumps({
        "session_id": "ignored",
        "user_message": "What operating constraints are available?",
        "top_k": 5,
        "include_reasoning": True,
        "update_memory_state": False,
    }).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {key}",
        "Content-Type": "application/json",
    },
    method="POST",
)

try:
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
except HTTPError as error:
    raise SystemExit(f"Adapt-1 returned HTTP {error.code}.") from error
except (URLError, TimeoutError, json.JSONDecodeError) as error:
    raise SystemExit("Request failed or returned invalid JSON.") from error

if not isinstance(result, dict) or "memory_context" not in result:
    raise SystemExit("Unexpected response shape; inspect the route contract.")

print(json.dumps(result, indent=2))

const key = process.env.ADAPT1_API_KEY;
if (!key) throw new Error("Set ADAPT1_API_KEY in your server environment.");

const response = await fetch(
  "https://rei-neuroadapt-api.reilabs.org/api/v1/memory/query",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${key}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      session_id: "ignored",
      user_message: "What operating constraints are available?",
      top_k: 5,
      include_reasoning: true,
      update_memory_state: false,
    }),
    signal: AbortSignal.timeout(60_000),
  },
);

if (!response.ok) {
  throw new Error(`Adapt-1 returned HTTP ${response.status}.`);
}
const result = await response.json();
if (!result || typeof result !== "object" || !("memory_context" in result)) {
  throw new Error("Unexpected response shape; inspect the route contract.");
}
console.log(JSON.stringify(result, null, 2));

Python uses the standard library. Run JavaScript as an .mjs file with Node.js 20 or later. Both examples run on the server.

Read the result

An empty evidence result is valid when nothing relevant has been stored. This is an illustrative minimal response, not a captured live result; the service can return additional fields.

Empty-evidence illustration

{
  "memory_context": [],
  "confidence_score": 0.0
}

Field	How to use it
`memory_context`	Evidence or context returned for this request. An empty value is not an authentication failure.
`confidence_score`	Route-defined support signal. Do not treat it as a calibrated probability of correctness.
`reasoning`	Optional structured reasoning when requested and available. Preserve it when the application needs an explanation.

Your code consumes these fields directly. Generated language is not required.

Why does the request contain session_id: ignored?

The hosted service resolves the effective identity from the bearer token. The body field satisfies this request’s compatibility contract; changing it does not select another tenant or create isolated state. Use a separate credential for a separate identity, or a separate domain_id for a task-scoped Domain.

Add a learning loop

The first call checks authentication and the response boundary. Next, run a complete learning example: create a fresh Domain, submit observations, inspect what was admitted, and query using retained state.

Build your first learned result

One complete Python file, included observations, before/after responses, and a read-only reuse step.

Choose a workflow

Start from the prediction, decision, evidence, or control result your application needs.

Build with an AI agent

Give your coding agent the request contract and an implementation checklist.

If the call fails

Symptom	First check
`401`	Confirm the key is present and sent as `Authorization: Bearer …`.
`422`	Check the field names and types; keep `session_id` and `user_message` nonempty.
Timeout or gateway failure	Check errors and reliability before adding retries.
Valid JSON, empty context	Continue with the learning example or store useful evidence.

For exact request boundaries and schema coverage, see HTTP and request contracts.

Get started

Concepts

Guides

Discovery

Operations

API reference

Set your API key

Make your first call

Read the result

Add a learning loop

Build your first learned result

Choose a workflow

Build with an AI agent

If the call fails

​Set your API key

​Make your first call

​Read the result

​Add a learning loop

Build your first learned result

Choose a workflow

Build with an AI agent

​If the call fails

Set your API key

Make your first call

Read the result

Add a learning loop

If the call fails