Quickstart

This guide takes you from a blank Deyta account to a working remember/recall roundtrip. Allow about five minutes.

1. Get an API key

Go to console.deyta.ai and sign in. New accounts land on a guided onboarding that creates your organization automatically.

Generate an API key

From the sidebar, open API Keys and click Generate. Give the key a recognizable name and copy the secret — it’s only shown once.

export DEYTA_API_KEY=sk_…

Treat API keys like any other production secret. Rotate them in the console as needed and prefer server-side environments over committing them to source control.

2. Create a namespace

Namespaces are Deyta Platform’s tenancy boundary. Every memory operation runs against one. Create one for this quickstart:

Console
TypeScript SDK
curl
Tab Title

Open Namespaces in the sidebar and click Create namespace. Pick any name; you can find the namespace ID in the console URL - https://console.deyta.ai/namespaces/<namespace-id>/settings/

npm install @deyta-ai/sdk

import { Deyta } from "@deyta-ai/sdk";

const deyta = new Deyta({ apiKey: process.env.DEYTA_API_KEY! });

const ns = await deyta.namespaces.create({
  name: "Quickstart",
  description: "Created by the quickstart guide",
});

console.log(ns.id);

You’ll get back a namespace record. Note the id — you’ll use it for the next two calls.

curl https://api.deyta.ai/gateway/v1/namespaces \
  -H "Authorization: Bearer $DEYTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Quickstart","description":"Created by the quickstart guide"}'

You’ll get back a namespace record. Note the id — you’ll use it for the next two calls.

3. Store a memory

Send some text to Deyta Platform. Behind the scenes it’s chunked, embedded, and entities are extracted into the namespace’s knowledge graph.

TypeScript SDK
curl

await deyta.memory.remember({
  namespace_id: ns.id,
  content: "The team standup is every Tuesday at 10am UTC.",
  title: "Standup time",
});

curl https://api.deyta.ai/gateway/v1/remember \
  -H "Authorization: Bearer $DEYTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace_id": "ns_…",
    "content": "The team standup is every Tuesday at 10am UTC.",
    "title": "Standup time"
  }'

The response includes counts of how many chunks, entities, and relationships were created.

4. Recall it

Search the namespace with a natural-language query. Deyta Platform returns the most relevant chunks ranked by hybrid score.

TypeScript SDK
curl

const result = await deyta.memory.recall({
  namespace_id: ns.id,
  query: "when is the standup?",
  limit: 3,
});

console.log(result.results);

curl https://api.deyta.ai/gateway/v1/recall \
  -H "Authorization: Bearer $DEYTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace_id": "ns_…",
    "query": "when is the standup?",
    "limit": 3
  }'

You should get back a result containing the standup memory, with a similarity score and the chunk text.

5. Synthesize an answer

recall returns raw matches. If you want a generated answer with cited sources, use ask:

TypeScript SDK
curl

const answer = await deyta.memory.ask({
  namespace_id: ns.id,
  query: "When is the standup and how often does it happen?",
});

console.log(answer.answer);

curl https://api.deyta.ai/gateway/v1/ask \
  -H "Authorization: Bearer $DEYTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace_id": "ns_…",
    "query": "When is the standup and how often does it happen?"
  }'

What’s next

Concepts

Understand namespaces, memories, ingestion, and retrieval before going further.

Connect a data source

Set up Google Drive, Snowflake, or object-store integrations for continuous ingestion.

SDK reference

The full TypeScript SDK — namespace scoping, retries, cancellation, typed errors.

API Reference

Every gateway endpoint with request/response schemas.

Getting started

Concepts

Console

Guides

Identities

1. Get an API key

2. Create a namespace

3. Store a memory

4. Recall it

5. Synthesize an answer

What’s next

Concepts

Connect a data source

SDK reference

API Reference

Getting started

Concepts

Console

Guides

Identities

​1. Get an API key

​2. Create a namespace

​3. Store a memory

​4. Recall it

​5. Synthesize an answer

​What’s next

Concepts

Connect a data source

SDK reference

API Reference

1. Get an API key

2. Create a namespace

3. Store a memory

4. Recall it

5. Synthesize an answer

What’s next