Skip to content
Docs
Esc
↑↓navigate↵open⌘Jpreview

List a team's memories

Returns the team’s active memories, all on one page, or with status=archived the archived ones, most recently archived first and paged by limit and cursor: pass the previous page’s pagination.nextCursor until hasMore is false. Each memory says who saved and last edited it. Pass spaceId to keep team-wide memories and that Space’s memories only. Use this to manage memories; before starting work, read getTeamAgentContext instead.

GET/v1/teams/{teamId}/memories
Authorization
AuthorizationBearer token · headerrequired

Better Auth session, OAuth access token, OAuth client-credentials token, or sfm_ Space machine credential.

or
AuthorizationOAuth2 access token · headerrequired

OAuth 2.0 with explicit Spacefast capability scopes. Use the authorization-code flow for people and client credentials for machines.

Scopes:spaces:read
Path parameters
teamIdstringrequired
min length 1
Query parameters
limitinteger

Page size.

min 1 · max 100 · default: 20
cursorstring

Opaque cursor from the previous page's nextCursor.

min length 1 · max length 4096
statusstring

Active memories (the default), all on one page, or archived ones, paged by limit and cursor.

default: "active"
Allowed:activearchived
spaceIdstring

Only team-wide memories and memories about this Space.

matches ^(spc_)[A-Za-z0-9]+$
Responses
200

Response for status 200

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

dataobject[]required

Active memories: pinned first, then the most recently updated. Archived memories: the most recently archived first.

Show properties
Array of object
idstringrequired
matches ^(mem_)[A-Za-z0-9]+$
teamIdstringrequired

Team the memory belongs to.

spaceIdstring | nullrequired

The Space the memory is about, or null for the whole team.

Show properties
Any of:
string
string
null
null
categorystringrequired

What kind of knowledge the memory holds.

Allowed:brandvoiceaudiencedesigndecisionconventionpreferencefact
titlestringrequired

Short title. Unique among the team's active memories in the same scope, ignoring case.

min length 3 · max length 80
bodystringrequired

One fact, decision, or preference in one to three sentences, with the reason.

min length 1 · max length 1000
pinnedbooleanrequired

Pinned memories come first in every agent-context read.

archivedAtstring<date-time> | nullrequired

When the memory was archived, or null while it is active.

Show properties
Any of:
string<date-time>
string<date-time>
null
null
createdByobjectrequired

Who wrote the memory.

Show properties
typestringrequired

person: a signed-in member. agent: an OAuth agent connection.

Allowed:personagentapi_keysystem
userIdstring | nullrequired

The person, or the person who connected the agent.

connectionIdstring | nullrequired

The agent connection (grant) that wrote it, for agent writes.

namestring | nullrequired

Display name: the person, agent, or API key.

updatedByobjectrequired

Who wrote the memory.

Show properties
typestringrequired

person: a signed-in member. agent: an OAuth agent connection.

Allowed:personagentapi_keysystem
userIdstring | nullrequired

The person, or the person who connected the agent.

connectionIdstring | nullrequired

The agent connection (grant) that wrote it, for agent writes.

namestring | nullrequired

Display name: the person, agent, or API key.

createdAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
updatedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
paginationobjectrequired
Show properties
nextCursorstring | nullrequired

Opaque cursor for the next page; null when there are no more results.

hasMorebooleanrequired

Whether another page exists after this one.

default

Problem details (RFC 9457). Any 4xx/5xx response is one application/problem+json document.

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

typestringrequired

Problem type URI resolving to the error docs page. The server derives it mechanically from code against the docs origin.

titlestringrequired

Short human-readable summary of the problem type. The server derives it mechanically from code.

statusintegerrequired

HTTP status code of this response, repeated in the body.

min -9007199254740991 · max 9007199254740991
detailstringrequired

Human-readable failure explanation for this occurrence.

codestringrequired

Stable snake_case error code naming the failed public contract.

pointerstring

RFC 6901 JSON Pointer into the failing request field, for example "/files/37/path", on validation failures.

detailsobject

Machine-readable context for the error code.

fixstring

One sentence on what to do about this error code, the same text as the type page. Read it before retrying.

suggestionsstring[]

Actionable recovery steps safe to show in dashboards, SDKs, and CLI output.

nextstring[]

Copy-pasteable commands or API requests an agent can run next.

requestIdstringrequired

The request id to quote when contacting support.

Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.spacefast.com/v1/teams/string/memories' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "$schema": "http://example.com",
  "data": [
    {
      "id": "string",
      "teamId": "string",
      "spaceId": "string",
      "category": "brand",
      "title": "string",
      "body": "string",
      "pinned": true,
      "archivedAt": "2019-08-24T14:15:22Z",
      "createdBy": {
        "type": "person",
        "userId": "string",
        "connectionId": "string",
        "name": "string"
      },
      "updatedBy": {
        "type": "person",
        "userId": "string",
        "connectionId": "string",
        "name": "string"
      },
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Was this page helpful?