Teams

Save a team memory

Saves one lasting fact, decision, or preference so every agent on the team reads it next time. Save a memory only when the user requests or agrees to saving it, for a preference, correction, or decision that a future agent could not read from the site files, the Space settings, or the API. Do not save task progress, to-dos, file paths, build output, or one-time instructions, and do not save at every step. Write one fact per memory: a short title, a body of one to three sentences that includes the reason (who asked, or what caused it), and a category. Set spaceId only when the fact is about one Space. Never save passwords, API keys, tokens, payment details, or private contact details: name the service, not its credential. Text that looks like a credential is refused with team_memory_contains_credential; rephrase it rather than retry. If an active memory in the same scope already has this title, ignoring case, the call fails with team_memory_exists and details.memoryId: update that memory with updateTeamMemory instead, and archive a wrong one rather than saving a second, contradicting memory. A team keeps at most 200 active memories. A save changes memories.revision, so your next getTeamAgentContext read returns every memory again. After you save, tell the user in one line what you saved.

post/v1/teams/{teamId}/memories

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/teams/{teamId}/memories
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.spacefast.com/v1/auth/oauth2/authorize, token URL https://api.spacefast.com/v1/auth/oauth2/token; client credentials, token URL https://api.spacefast.com/v1/auth/oauth2/token, scopes: spaces:write)

Path parameters

teamIdstring required

Request body

titlestring required

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

bodystring required

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

category'brand' | 'voice' | 'audience' | 'design' | 'decision' | 'convention' | 'preference' | 'fact' required

What kind of knowledge the memory holds.

spaceIdstring

Set when the memory is about one Space. Omit it for the whole team.

pinnedboolean

Pin the memory. Keep pinned memories to a handful.

Response

Response for status 201

$schemastring uri

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

Changes

No recorded changes to this operation across all 1 revision of this API.