POST
/
v1
/
teams
/
{teamId}
/
team-memory
/
proposals
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.teamMemory.proposeTeamMemory({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  body: {},
})
{
  "entry": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "key": "<string>",
    "scope": "<string>",
    "title": "<string>",
    "description": "<string>",
    "content": "<string>",
    "pinned": true,
    "sourceRef": "<string>",
    "confidence": 123,
    "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "actorUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "verified": true,
    "current": true,
    "embedded": true,
    "createdAt": "<string>"
  },
  "supersededEntryId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Body

application/json
​
kind
enum<string>
required

observation for something noticed during the run, company_fact for something true about the business.

Available options:
observation,
company_fact
​
title
string
required

Short one-line label for the memory, 1-200 characters, no control characters.

Required string length: 1 - 200
Pattern: ^[^\u0000-\u001F\u007F-\u009F]*$
​
content
string
required

The memory itself in plain text or markdown, 1-4000 characters.

Required string length: 1 - 4000
​
description
string

Optional one-line summary, up to 500 characters.

Maximum string length: 500
​
confidence
number

How sure the writer is that the memory is true, from 0 to 1.

Required range: 0 <= x <= 1

Response

Success

​
entry
object
required
​
supersededEntryId
string<uuid> | null
required

The entry this append superseded; null when the key was new.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
embedding
enum<string>
required

pending when the vector could not be created yet; the entry is still found by keyword search and can be embedded later by the backfill endpoint.

Available options:
ready,
pending