Skip to main content
GET
Get one memory job run

Authorizations

Authorization
string
header
required

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

Headers

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 whose memory activity contains the run.

runId
string<uuid>
required

Memory run id returned by managedAgentsListAgentMemoryJobRuns. reflection_id returned by managedAgentsListAgentMemoryJobRuns.

Response

OK

addedCount
integer<int64>
required

Memories added by this run.

Required range: -9007199254740991 <= x <= 9007199254740991
agentId
string
required

Agent whose memory this run updates.

createdAt
string<date-time>
required

Server-assigned run creation time.

memoryStoreId
string
required

Collection updated by this run.

mergedCount
integer<int64>
required

Memories merged by this run.

Required range: -9007199254740991 <= x <= 9007199254740991
retiredCount
integer<int64>
required

Memories retired by this run.

Required range: -9007199254740991 <= x <= 9007199254740991
runId
string
required

Server-assigned id of the memory run.

status
enum<string>
required

Current run status.

Available options:
pending,
running,
completed,
failed,
canceled
triggeredBy
enum<string>
required

What started this run.

Available options:
schedule,
counter,
manual
updatedAt
string<date-time>
required

Most recent run update time.

updatedCount
integer<int64>
required

Memories refined by this run.

Required range: -9007199254740991 <= x <= 9007199254740991
agentVersionId
string

Agent version at the start of the run.

digestCount
integer<int64>

Number of session reports read.

Required range: -9007199254740991 <= x <= 9007199254740991
driverSessionId
string

Session that executed this run.

endedAt
string<date-time>

Time the run reached a terminal status.

errorMessage
string

Failure detail when the run failed.

errorType
string

Failure classification when the run failed.

inputSessionIds
string[]

Sessions whose reports this run read.

instructions
string

Standing guidance used by this run.

model
string

Model used by this run.

modelRefId
string

Model reference used by this run.