---
title: "Push Memory Tree Ops"
method: POST
path: "/api/memory/tree/ops"
---

# Push Memory Tree Ops

`POST /api/memory/tree/ops`

## Request

- Base URL: `https://api.omicos.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://api.omicos.cn/api/memory/tree/ops`
- Auth: none declared

A core uploads its local operations; the server replays them onto the
authoritative tree (user decisions always apply, model writes must pass
the evidence rules) and returns the merged tree for the core to rebase on.
Idempotent per op_id. A model's judgment or rule from a conversation we
have no copy of yet is `deferred` (settled when it arrives; meanwhile the
returned tree shows it, so the core keeps it).

## Headers

- `authorization` string, nullable
- `x-omicos-device` string, nullable
- `x-omicos-device-kind` string, nullable
- `x-omicos-device-name` string, nullable

## Request body

- MemoryTreeOpsIn
  - `ops` object[]

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `ef3006b6f052`: 3 info
  - added the new optional `header` request parameter `x-omicos-device`
  - added the new optional `header` request parameter `x-omicos-device-kind`
  - added the new optional `header` request parameter `x-omicos-device-name`
- **2026-10-16** `d96f8cb593c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omicos/apis/omicos-server/changes/api/memory/tree/ops/post.md)

---

[API](https://skmtc.dev/omicos/apis/omicos-server.md) · [All operations](https://skmtc.dev/omicos/apis/omicos-server/llms.txt) · [OpenAPI document](https://skmtc.dev/omicos/apis/omicos-server/revisions/42ce180a8cda?raw)