Messages

Get Task Status

Query the processing status of async tasks such as add/message and add/feedback. When a task completes, the response includes memory_views with added/updated/deleted counts and memory IDs grouped by memory category.

POST
/
get
/
status
import os
import requests
import json

# Replace with your API Key
os.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"
os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "task_id": "40aae834-4248-4944-b2bb-a674f37a2fdb" # Replace with the Task ID to query
}
headers = {
  "Content-Type": "application/json",
  "Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/get/status"

res = requests.post(url=url, headers=headers, data=json.dumps(data))

print(f"result: {res.json()}")
{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "c464e17e-f2ff-4e9a-a2c2-41cc55ab43b9",
    "status": "completed",
    "memory_views": {
      "added": 1,
      "updated": 1,
      "deleted": 0,
      "detail_factual": {
        "memory_ids": [
          "memos_mem_001"
        ]
      },
      "preference": {
        "memory_ids": [
          "memos_mem_002"
        ]
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Token API_key, available in API Console > API Keys

Body

application/json
task_id
string
required
Async task ID returned by add/message, add/feedback, and other async endpoints.

Response

application/json

Successful Response

code
number
required

API status code. See Error Code for details.

data
object
Show child attributes
message
string
required

API response message