Update an agent's memory settings

curl --request PATCH \
  --url https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'If-Match: <if-match>' \
  --data '
{
  "cooldownSeconds": 0,
  "enabled": true,
  "instructions": "<string>",
  "maxEvidencePerRun": 0,
  "memoryModelRef": "<string>",
  "minNewEvidence": 0,
  "reflectorAgentId": "<string>"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings"

payload = {
    "cooldownSeconds": 0,
    "enabled": True,
    "instructions": "<string>",
    "maxEvidencePerRun": 0,
    "memoryModelRef": "<string>",
    "minNewEvidence": 0,
    "reflectorAgentId": "<string>"
}
headers = {
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cooldownSeconds: 0,
    enabled: true,
    instructions: '<string>',
    maxEvidencePerRun: 0,
    memoryModelRef: '<string>',
    minNewEvidence: 0,
    reflectorAgentId: '<string>'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings', 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/agents/{agentId}/memory/settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'cooldownSeconds' => 0,
    'enabled' => true,
    'instructions' => '<string>',
    'maxEvidencePerRun' => 0,
    'memoryModelRef' => '<string>',
    'minNewEvidence' => 0,
    'reflectorAgentId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "If-Match: <if-match>"
  ],
]);

$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/agents/{agentId}/memory/settings"

	payload := strings.NewReader("{\n  \"cooldownSeconds\": 0,\n  \"enabled\": true,\n  \"instructions\": \"<string>\",\n  \"maxEvidencePerRun\": 0,\n  \"memoryModelRef\": \"<string>\",\n  \"minNewEvidence\": 0,\n  \"reflectorAgentId\": \"<string>\"\n}")

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

	req.Header.Add("If-Match", "<if-match>")
	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.patch("https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings")
  .header("If-Match", "<if-match>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cooldownSeconds\": 0,\n  \"enabled\": true,\n  \"instructions\": \"<string>\",\n  \"maxEvidencePerRun\": 0,\n  \"memoryModelRef\": \"<string>\",\n  \"minNewEvidence\": 0,\n  \"reflectorAgentId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings")

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

request = Net::HTTP::Patch.new(url)
request["If-Match"] = '<if-match>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"cooldownSeconds\": 0,\n  \"enabled\": true,\n  \"instructions\": \"<string>\",\n  \"maxEvidencePerRun\": 0,\n  \"memoryModelRef\": \"<string>\",\n  \"minNewEvidence\": 0,\n  \"reflectorAgentId\": \"<string>\"\n}"

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

{
  "cooldownSeconds": 0,
  "effectiveCooldownSeconds": 0,
  "effectiveMaxEvidencePerRun": 0,
  "effectiveMinNewEvidence": 0,
  "enabled": true,
  "enabledEditable": true,
  "maxEvidencePerRun": 0,
  "minNewEvidence": 0,
  "instructions": "<string>",
  "memoryModelRef": "<string>",
  "reflectorAgentId": "<string>",
  "revision": "<string>"
}

{
  "code": "invalid_json",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_conflict",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "precondition_failed",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "payload_too_large",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "precondition_required",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

PATCH

managed-agents

agents

{agentId}

memory

settings

Update an agent's memory settings

curl --request PATCH \
  --url https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'If-Match: <if-match>' \
  --data '
{
  "cooldownSeconds": 0,
  "enabled": true,
  "instructions": "<string>",
  "maxEvidencePerRun": 0,
  "memoryModelRef": "<string>",
  "minNewEvidence": 0,
  "reflectorAgentId": "<string>"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings"

payload = {
    "cooldownSeconds": 0,
    "enabled": True,
    "instructions": "<string>",
    "maxEvidencePerRun": 0,
    "memoryModelRef": "<string>",
    "minNewEvidence": 0,
    "reflectorAgentId": "<string>"
}
headers = {
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cooldownSeconds: 0,
    enabled: true,
    instructions: '<string>',
    maxEvidencePerRun: 0,
    memoryModelRef: '<string>',
    minNewEvidence: 0,
    reflectorAgentId: '<string>'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings', 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/agents/{agentId}/memory/settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'cooldownSeconds' => 0,
    'enabled' => true,
    'instructions' => '<string>',
    'maxEvidencePerRun' => 0,
    'memoryModelRef' => '<string>',
    'minNewEvidence' => 0,
    'reflectorAgentId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "If-Match: <if-match>"
  ],
]);

$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/agents/{agentId}/memory/settings"

	payload := strings.NewReader("{\n  \"cooldownSeconds\": 0,\n  \"enabled\": true,\n  \"instructions\": \"<string>\",\n  \"maxEvidencePerRun\": 0,\n  \"memoryModelRef\": \"<string>\",\n  \"minNewEvidence\": 0,\n  \"reflectorAgentId\": \"<string>\"\n}")

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

	req.Header.Add("If-Match", "<if-match>")
	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.patch("https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings")
  .header("If-Match", "<if-match>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cooldownSeconds\": 0,\n  \"enabled\": true,\n  \"instructions\": \"<string>\",\n  \"maxEvidencePerRun\": 0,\n  \"memoryModelRef\": \"<string>\",\n  \"minNewEvidence\": 0,\n  \"reflectorAgentId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/agents/{agentId}/memory/settings")

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

request = Net::HTTP::Patch.new(url)
request["If-Match"] = '<if-match>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"cooldownSeconds\": 0,\n  \"enabled\": true,\n  \"instructions\": \"<string>\",\n  \"maxEvidencePerRun\": 0,\n  \"memoryModelRef\": \"<string>\",\n  \"minNewEvidence\": 0,\n  \"reflectorAgentId\": \"<string>\"\n}"

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

{
  "cooldownSeconds": 0,
  "effectiveCooldownSeconds": 0,
  "effectiveMaxEvidencePerRun": 0,
  "effectiveMinNewEvidence": 0,
  "enabled": true,
  "enabledEditable": true,
  "maxEvidencePerRun": 0,
  "minNewEvidence": 0,
  "instructions": "<string>",
  "memoryModelRef": "<string>",
  "reflectorAgentId": "<string>",
  "revision": "<string>"
}

{
  "code": "invalid_json",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_conflict",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "precondition_failed",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "payload_too_large",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "precondition_required",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "idempotency_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

Authorizations

Authorization

string

header

required

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

Headers

Idempotency-Key

string

Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. For the legacy automation-run route only, the historical fingerprint ignores top-level JSON formatting and object-key order and removes the retired top-level idempotency_key field. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.

Required string length: 1 - 256

Pattern: ^[!-~]+$

If-Match

string

required

Strong ETag from the latest memory settings read. A stale validator returns 412.

Pattern: ^(?:W/)?"[\u0021\u0023-\u007E\u0080-\u00FF]*"$

x-tenant-id

string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1

x-organization-id

string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

agentId

string<uuid>

required

Agent id (UUID) as returned by managedAgentsCreateAgent or managedAgentsListAgents.

Body

application/json

A partial update to one Recursion agent's memory policy. Omitted fields remain unchanged.

cooldownSeconds

null | integer<int64>

Minimum seconds between consolidations, from 3600 to 86400. Zero or null restores the platform default of 3600; omit to leave unchanged.

Required range: -9007199254740991 <= x <= 9007199254740991

enabled

null | boolean

Opt this agent into or out of automatic memory. Null restores the deployment default; omit to leave unchanged.

instructions

null | string

Standing curator guidance, at most 4096 characters. Null clears it.

maxEvidencePerRun

null | integer<int64>

Maximum reports read per consolidation, from 1 to 50. Zero or null restores the platform default of 50; omit to leave unchanged.

Required range: -9007199254740991 <= x <= 9007199254740991

memoryModelRef

null | string

Model override for all memory stages. Null restores the Luna default; omit to leave unchanged.

minNewEvidence

null | integer<int64>

New useful reports that trigger an early consolidation, from 1 to 50; the first run and aged backlog can run below this threshold. Zero or null restores the platform default of 5; omit to leave unchanged.

Required range: -9007199254740991 <= x <= 9007199254740991

reflectorAgentId

null | string

Agent selected as curator. Null restores the platform curator.

Response

Model and guidance for automatic learning from a Recursion agent's finished sessions. An empty model selection uses the Luna default.

cooldownSeconds

integer<int64>

required

Minimum time between consolidation runs in seconds; 0 inherits the platform default of 3600.

Required range: -9007199254740991 <= x <= 9007199254740991

effectiveCooldownSeconds

integer<int64>

required

read-only

Active minimum seconds between runs after applying inheritance.

Required range: -9007199254740991 <= x <= 9007199254740991

effectiveMaxEvidencePerRun

integer<int64>

required

read-only

Active report limit after applying inheritance.

Required range: -9007199254740991 <= x <= 9007199254740991

effectiveMinNewEvidence

integer<int64>

required

read-only

Active early-consolidation threshold after applying inheritance.

Required range: -9007199254740991 <= x <= 9007199254740991

enabled

boolean

required

Whether this agent learns from completed sessions and attaches its learned store to new sessions.

enabledEditable

boolean

required

read-only

Whether this deployment permits changing the enabled setting.

maxEvidencePerRun

integer<int64>

required

Maximum reports one consolidation may read; 0 inherits the platform default of 50.

Required range: -9007199254740991 <= x <= 9007199254740991

minNewEvidence

integer<int64>

required

New useful reports that trigger an early consolidation; the first run and aged backlog can run below this threshold. 0 inherits the platform default of 5.

Required range: -9007199254740991 <= x <= 9007199254740991

instructions

string

Standing guidance for every memory consolidation run. Capped at 4096 characters.

memoryModelRef

string

Model used for all memory learning stages. Empty uses the Luna default.

reflectorAgentId

string

Agent selected to curate this agent's memory. Empty uses the platform curator.

revision

string

read-only

Strong revision validator for the current settings representation. Send it in If-Match when changing settings.

API reference

Endpoints

Update an agent's memory settings

Authorizations

Headers

Path Parameters

Body

Response