Retrieve Memory
import requests
url = "https://api.parallel.ai/v1beta/memory/retrieve"
payload = {
"query": "<string>",
"limit": 10,
"since": "2026-07-15T17:30:00Z",
"memory_scope_key": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
limit: 10,
since: '2026-07-15T17:30:00Z',
memory_scope_key: '<string>'
})
};
fetch('https://api.parallel.ai/v1beta/memory/retrieve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.parallel.ai/v1beta/memory/retrieve")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"limit\": 10,\n \"since\": \"2026-07-15T17:30:00Z\",\n \"memory_scope_key\": \"<string>\"\n}")
.asString();curl --request POST \
--url https://api.parallel.ai/v1beta/memory/retrieve \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"query": "<string>",
"limit": 10,
"since": "2026-07-15T17:30:00Z",
"memory_scope_key": "<string>"
}
'{
"results": [
{
"id": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"input_excerpt": "<string>",
"output_excerpt": "<string>",
"kind": "task"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Memory
Retrieve Memory
Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.
POST
/
v1beta
/
memory
/
retrieve
Retrieve Memory
import requests
url = "https://api.parallel.ai/v1beta/memory/retrieve"
payload = {
"query": "<string>",
"limit": 10,
"since": "2026-07-15T17:30:00Z",
"memory_scope_key": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
limit: 10,
since: '2026-07-15T17:30:00Z',
memory_scope_key: '<string>'
})
};
fetch('https://api.parallel.ai/v1beta/memory/retrieve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.parallel.ai/v1beta/memory/retrieve")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"limit\": 10,\n \"since\": \"2026-07-15T17:30:00Z\",\n \"memory_scope_key\": \"<string>\"\n}")
.asString();curl --request POST \
--url https://api.parallel.ai/v1beta/memory/retrieve \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"query": "<string>",
"limit": 10,
"since": "2026-07-15T17:30:00Z",
"memory_scope_key": "<string>"
}
'{
"results": [
{
"id": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"input_excerpt": "<string>",
"output_excerpt": "<string>",
"kind": "task"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Body
application/json
Concise query describing the memories to retrieve. Empty queries return the most recent memories.
Maximum string length:
500Maximum number of memories to return.
Required range:
1 <= x <= 25Filter memories by kind: task, monitor, or findall.
Available options:
task, monitor, findall Only return memories sourced from task, monitor, or FindAll runs completed at or after this RFC 3339 timestamp.
Example:
"2026-07-15T17:30:00Z"
User-provided key identifying the memory scope to use. Omit to use personal memory, if available.
Required string length:
1 - 128Pattern:
^[a-zA-Z0-9_-]+$Response
Successful Response
results
(TaskMemoryResult · object | MonitorMemoryResult · object | FindAllMemoryResult · object)[]
required
- TaskMemoryResult
- MonitorMemoryResult
- FindAllMemoryResult
Show child attributes
Show child attributes