Create Project

curl --request POST \
  --url http://localhost:8080/api/v2/projects \
  --header 'Content-Type: application/json' \
  --data '
{
  "org_id": "acme-corp",
  "project_id": "agent-smith-v1",
  "description": "Primary memory store for customer support agent",
  "config": {
    "embedder": "openai-text-3-small",
    "reranker": "cohere-rerank-english-v3.0"
  }
}
'

import requests

url = "http://localhost:8080/api/v2/projects"

payload = {
    "org_id": "acme-corp",
    "project_id": "agent-smith-v1",
    "description": "Primary memory store for customer support agent",
    "config": {
        "embedder": "openai-text-3-small",
        "reranker": "cohere-rerank-english-v3.0"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    org_id: 'acme-corp',
    project_id: 'agent-smith-v1',
    description: 'Primary memory store for customer support agent',
    config: {embedder: 'openai-text-3-small', reranker: 'cohere-rerank-english-v3.0'}
  })
};

fetch('http://localhost:8080/api/v2/projects', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8080",
  CURLOPT_URL => "http://localhost:8080/api/v2/projects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'org_id' => 'acme-corp',
    'project_id' => 'agent-smith-v1',
    'description' => 'Primary memory store for customer support agent',
    'config' => [
        'embedder' => 'openai-text-3-small',
        'reranker' => 'cohere-rerank-english-v3.0'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:8080/api/v2/projects"

	payload := strings.NewReader("{\n  \"org_id\": \"acme-corp\",\n  \"project_id\": \"agent-smith-v1\",\n  \"description\": \"Primary memory store for customer support agent\",\n  \"config\": {\n    \"embedder\": \"openai-text-3-small\",\n    \"reranker\": \"cohere-rerank-english-v3.0\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost:8080/api/v2/projects")
  .header("Content-Type", "application/json")
  .body("{\n  \"org_id\": \"acme-corp\",\n  \"project_id\": \"agent-smith-v1\",\n  \"description\": \"Primary memory store for customer support agent\",\n  \"config\": {\n    \"embedder\": \"openai-text-3-small\",\n    \"reranker\": \"cohere-rerank-english-v3.0\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost:8080/api/v2/projects")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"org_id\": \"acme-corp\",\n  \"project_id\": \"agent-smith-v1\",\n  \"description\": \"Primary memory store for customer support agent\",\n  \"config\": {\n    \"embedder\": \"openai-text-3-small\",\n    \"reranker\": \"cohere-rerank-english-v3.0\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "org_id": "<string>",
  "project_id": "<string>",
  "description": "",
  "config": {
    "reranker": "",
    "embedder": "",
    "vector_graph_store": "",
    "vector_store": "",
    "segment_store": "",
    "properties_schema": {}
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Projects

Create Project

Create a new project.

This endpoint creates a project under the specified organization using the provided identifiers and configuration. Both org_id and project_id follow the rules: no slashes; only letters, numbers, underscores, hyphens, colon, and Unicode characters.

Each project acts as an isolated memory namespace. All memories (episodes) inserted into a project belong exclusively to that project. Queries, listings, and any background operations such as memory summarization or knowledge extraction only access data within the same project. No cross-project memory access is allowed.

If a project with the same ID already exists within the organization, the request will fail with an error.

Returns the fully resolved project record, including configuration defaults applied by the system.

POST

api

projects

Create Project

curl --request POST \
  --url http://localhost:8080/api/v2/projects \
  --header 'Content-Type: application/json' \
  --data '
{
  "org_id": "acme-corp",
  "project_id": "agent-smith-v1",
  "description": "Primary memory store for customer support agent",
  "config": {
    "embedder": "openai-text-3-small",
    "reranker": "cohere-rerank-english-v3.0"
  }
}
'

import requests

url = "http://localhost:8080/api/v2/projects"

payload = {
    "org_id": "acme-corp",
    "project_id": "agent-smith-v1",
    "description": "Primary memory store for customer support agent",
    "config": {
        "embedder": "openai-text-3-small",
        "reranker": "cohere-rerank-english-v3.0"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    org_id: 'acme-corp',
    project_id: 'agent-smith-v1',
    description: 'Primary memory store for customer support agent',
    config: {embedder: 'openai-text-3-small', reranker: 'cohere-rerank-english-v3.0'}
  })
};

fetch('http://localhost:8080/api/v2/projects', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8080",
  CURLOPT_URL => "http://localhost:8080/api/v2/projects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'org_id' => 'acme-corp',
    'project_id' => 'agent-smith-v1',
    'description' => 'Primary memory store for customer support agent',
    'config' => [
        'embedder' => 'openai-text-3-small',
        'reranker' => 'cohere-rerank-english-v3.0'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:8080/api/v2/projects"

	payload := strings.NewReader("{\n  \"org_id\": \"acme-corp\",\n  \"project_id\": \"agent-smith-v1\",\n  \"description\": \"Primary memory store for customer support agent\",\n  \"config\": {\n    \"embedder\": \"openai-text-3-small\",\n    \"reranker\": \"cohere-rerank-english-v3.0\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost:8080/api/v2/projects")
  .header("Content-Type", "application/json")
  .body("{\n  \"org_id\": \"acme-corp\",\n  \"project_id\": \"agent-smith-v1\",\n  \"description\": \"Primary memory store for customer support agent\",\n  \"config\": {\n    \"embedder\": \"openai-text-3-small\",\n    \"reranker\": \"cohere-rerank-english-v3.0\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost:8080/api/v2/projects")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"org_id\": \"acme-corp\",\n  \"project_id\": \"agent-smith-v1\",\n  \"description\": \"Primary memory store for customer support agent\",\n  \"config\": {\n    \"embedder\": \"openai-text-3-small\",\n    \"reranker\": \"cohere-rerank-english-v3.0\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "org_id": "<string>",
  "project_id": "<string>",
  "description": "",
  "config": {
    "reranker": "",
    "embedder": "",
    "vector_graph_store": "",
    "vector_store": "",
    "segment_store": "",
    "properties_schema": {}
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Body

application/json

Specification model for creating a new project.

A project belongs to an organization and has its own identifiers, description, and configuration. The project ID must be unique within the organization.

org_id

string

required

The unique identifier of the organization.

- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
  are allowed.

This value determines the namespace the project belongs to.

Examples:

"MemVerge"

"AI_Labs"

project_id

string

required

The identifier of the project.

- Must be unique within the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
  are allowed.

This ID is used in API paths and resource locations.

Examples:

"memmachine"

"research123"

"qa_pipeline"

description

string

default:""

A human-readable description of the project.
Used for display purposes in UIs and dashboards.
Optional; defaults to an empty string.

Examples:

"Test project for RAG pipeline"

"Production semantic search index"

config

ProjectConfig · object

Configuration settings associated with this project.

Defines which models (reranker, embedder) to use. If any values within
`ProjectConfig` are empty, global defaults are applied.

Show child attributes

Response

Successful Response

Response model returned after project operations (e.g., creation, update, fetch).

Contains the resolved identifiers and configuration of the project as stored in the system. Field formats follow the same validation rules as in CreateProjectSpec.

org_id

string

required

The unique identifier of the organization this project belongs to.

Returned exactly as stored by the system.

project_id

string

required

The identifier of the project.

This value uniquely identifies the project within the organization.

description

string

default:""

A human-readable description of the project.
Used for display purposes in UIs and dashboards.
Optional; defaults to an empty string.

config

ProjectConfig · object

Configuration settings associated with this project.

Defines which models (reranker, embedder) to use. If any values within
`ProjectConfig` are empty, global defaults are applied.

Show child attributes

Delete Semantic Memory

Delete Project

Introduction

MCP Tools

REST API

Typescript REST SDK

PythonSDK Client

Python SDK Server

Create Project

Body

Response