List project memories
const url = 'https://example.com/api/v1/org/example/ws/example/projects/example/project-memory/list';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"include_closed":false,"limit":50,"page":1,"project_filter":"workspace","scope_kind":"project","session_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","sort_by":"updated_at","sort_dir":"asc","status":"open","subtype":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/v1/org/example/ws/example/projects/example/project-memory/list \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "include_closed": false, "limit": 50, "page": 1, "project_filter": "workspace", "scope_kind": "project", "session_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "sort_by": "updated_at", "sort_dir": "asc", "status": "open", "subtype": "example" }'List project memories scoped to the current project by default. Set project_filter=‘workspace’ for explicit workspace-wide reads. Set status to ‘open’, ‘closed’, or ‘all’ to filter by lifecycle state. Set session_id to list only memories created, updated, or closed in that session; the status filter still applies to them. Results are paged: limit is the page size and page picks the page, ordered by sort_by and sort_dir (most recently updated first by default). The response carries total, the number of memories matching the filters.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Organization slug
Organization slug
Workspace slug
Workspace slug
Project slug or UUID
Project slug or UUID
Request Bodyrequired
Section titled “Request Bodyrequired”Tool-contract request for listing project memories.
object
Page size: the most memories this call returns.
1-indexed page of limit memories.
Column to order by. Ties fall back to id in the same direction.
Responses
Section titled “ Responses ”Successful Response
Tool-contract response for list_memories: one page plus the filtered total.
object
Whether a next page exists
Whether a previous page exists
Maximum items per page
Narrow list record returned by project memory list calls.
object
One version a session wrote, with the status it changed from.
Current page number (1-indexed)
Total items matching the query
Total number of pages
Example
{ "memories": [ { "closed_reason": "false_positive", "session_changes": [ { "previous_status": "open", "status": "open" } ], "status": "open" } ]}Invalid request
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Authentication failed
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Access forbidden
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Not found
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Already exists
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Validation error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Upgrade required
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Rate limited
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Internal server error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Bad gateway
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Gateway timeout
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}