Skip to content

The project’s rules

GET
/v1/memory/rules
curl --request GET \
--url 'https://beta-api.plune.ai/v1/memory/rules?state=in_force' \
--header 'Authorization: Bearer <token>'

The rules of the project’s memory (#2198), oldest accepted first: what an agent working on the project reads before it asks. Any token reads them, a read token included. state: in_force (the default), retired, or all.

state
string
default: in_force
Allowed values: in_force retired all

The rules

Media type application/json
object
rules
required
Array<object>

A rule of the project’s memory (#2198): what a person accepted, from where, and whether it is still in force.

object
id
required
string format: uuid
text
required
string
source
required

Where a candidate rule came from (#2198), and its identity: one source is one candidate and one rule. answer: a person’s answer to a question; decline: the reason a person rejected a queue entry with; failure_choice (#2195): the action a person picked in a question on a failed test; report_lesson (#2193): a lesson of an approved mission report.

object
kind
required
string
Allowed values: answer decline failure_choice report_lesson
id
required

The record: a review item; for report_lesson, <the report’s review item>:<the lesson’s questionId>.

string
>= 1 characters <= 200 characters
reviewItemId
required

The candidate entry a person approved.

string format: uuid
acceptedBy
required

The user who approved it, in a session.

string
acceptedAt
required
string format: date-time
inForce
required

False once retired. A retired rule is kept, and is neither read by default nor exported.

boolean
retiredBy

Present on a retired rule.

string
retiredAt

Present on a retired rule.

string format: date-time
Example
{
"rules": [
{
"id": "6f1c2b3a-0000-4000-8000-000000002198",
"text": "Which flow is the checkout: the one-page form or the three steps?\nAnswer: Three steps",
"source": {
"kind": "answer",
"id": "6f1c2b3a-0000-4000-8000-0000000021a9"
},
"reviewItemId": "6f1c2b3a-0000-4000-8000-0000000021c8",
"acceptedBy": "6f1c2b3a-0000-4000-8000-0000000000a2",
"acceptedAt": "2026-09-16T09:12:04.151Z",
"inForce": true
}
]
}

A state that is none of the three

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid token or session