---
title: "Test and save an embeddings configuration for onboarding"
method: POST
path: "/api/onboarding/memory"
tags: ["Onboarding"]
---

# Test and save an embeddings configuration for onboarding

`POST /api/onboarding/memory`

## Request body

- object
  - `preset` 'openai' | 'openrouter' | 'vercel' | 'custom' | 'existing', required
  - `baseUrl` string, uri
  - `model` string
  - `apiKey` string
  - `reuseKey` 'OPENAI_API_KEY' | 'OPENROUTER_API_KEY'

## Response `200`

Embedding probe result

- object
  - `ok` boolean, required
  - `dimensions` integer
  - `latencyMs` integer, required
  - `error` string
  - `errorClass` 'auth' | 'network' | 'timeout' | 'dimension' | 'model' | 'not_enabled' | 'expired' | 'unknown'

## Other responses

- `400` — Invalid memory configuration

## Changes

- **2026-09-25** `452be3d6b59a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/onboarding/memory/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/01e2386c97da?raw)