Create a memory store

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/memory_stores \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "description": "example",
  "name": "example-name"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/memory_stores"

payload = {
    "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
    "description": "example",
    "name": "example-name"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    agent_id: '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
    description: 'example',
    name: 'example-name'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/memory_stores', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/memory_stores",
  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([
    'agent_id' => '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
    'description' => 'example',
    'name' => 'example-name'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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 := "https://api.recursion.labelbox.com/managed-agents/v1/memory_stores"

	payload := strings.NewReader("{\n  \"agent_id\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n  \"description\": \"example\",\n  \"name\": \"example-name\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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("https://api.recursion.labelbox.com/managed-agents/v1/memory_stores")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"agent_id\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n  \"description\": \"example\",\n  \"name\": \"example-name\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/memory_stores")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"agent_id\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n  \"description\": \"example\",\n  \"name\": \"example-name\"\n}"

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

{
  "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "archived_at": "2026-02-18T09:30:00.000Z",
  "created_at": "2026-02-18T09:30:00.000Z",
  "created_by": "example",
  "description": "example",
  "memory_count": 1,
  "memory_store_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "name": "example-name",
  "organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "origin": "curated",
  "revision": 1,
  "slug": "example",
  "status": "active",
  "total_bytes": 1,
  "updated_at": "2026-02-18T09:30:00.000Z"
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

POST

managed-agents

memory_stores

Create a memory store

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/memory_stores \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "description": "example",
  "name": "example-name"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/memory_stores"

payload = {
    "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
    "description": "example",
    "name": "example-name"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    agent_id: '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
    description: 'example',
    name: 'example-name'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/memory_stores', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/memory_stores",
  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([
    'agent_id' => '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
    'description' => 'example',
    'name' => 'example-name'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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 := "https://api.recursion.labelbox.com/managed-agents/v1/memory_stores"

	payload := strings.NewReader("{\n  \"agent_id\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n  \"description\": \"example\",\n  \"name\": \"example-name\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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("https://api.recursion.labelbox.com/managed-agents/v1/memory_stores")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"agent_id\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n  \"description\": \"example\",\n  \"name\": \"example-name\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/memory_stores")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"agent_id\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n  \"description\": \"example\",\n  \"name\": \"example-name\"\n}"

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

{
  "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "archived_at": "2026-02-18T09:30:00.000Z",
  "created_at": "2026-02-18T09:30:00.000Z",
  "created_by": "example",
  "description": "example",
  "memory_count": 1,
  "memory_store_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "name": "example-name",
  "organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "origin": "curated",
  "revision": 1,
  "slug": "example",
  "status": "active",
  "total_bytes": 1,
  "updated_at": "2026-02-18T09:30:00.000Z"
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Body

application/json

Fields for creating or renaming a curated memory store. An omitted field is left unchanged on update.

agent_id

string

Scope the store to one agent. Omit for a workspace store any session may attach.

description

string

What this store contains. Disclosed to the agent in every session the store is attached to, so write it as what the agent would be looking for.

name

string

Human-readable name. Shown to the agent as part of the store's note.

Response

A collection of path-addressed documents an agent reads across sessions. Attaching a store adds one note to the system prompt naming what it contains; the agent browses, searches, and reads its contents on demand, so store size does not enter the prompt.

created_at

string<date-time>

required

Server-assigned RFC 3339 timestamp of when the store was created.

memory_count

integer<int64>

required

Number of live memories in the store.

memory_store_id

string

required

Server-assigned id of the store, used when attaching it to a session and in the memory routes.

name

string

required

Human-readable name. Shown to the agent as part of the store's note.

organization_id

string

required

Organization that owns the store. Server-assigned from the caller's credentials; a value sent in a request body is ignored.

origin

enum<string>

required

Who wrote this store: curated for material a person added, reflection for an agent's learned memory. A reflection store is not hand-editable.

Available options:

curated,

reflection

revision

integer<int64>

required

Monotonic revision of the collection, advanced atomically when a learning run changes memories.

slug

string

required

Filesystem-safe form of the name, stable across renames.

status

enum<string>

required

Active collections are available to sessions; archived curated stores cannot be attached.

Available options:

active,

archived

total_bytes

integer<int64>

required

Total bytes of live memory content in the store.

updated_at

string<date-time>

required

Server-assigned RFC 3339 timestamp of the most recent change to the store or its memories.

agent_id

string

Agent this store belongs to. Empty for a workspace store any session may attach.

archived_at

string<date-time>

Set when a curated reference store was archived.

created_by

string

Identifier of the caller or reflection that created the store.

description

string

What this store contains. Disclosed to the agent in every session the store is attached to, so it is the routing signal: write it as what the agent would be looking for.

API reference

Endpoints

Create a memory store

Authorizations

Body

Response