Commit patches wrapped as { patches: [...] } (5 min client timeout)

POST

/v1/patches/bulk

curl --request POST \
  --url http://localhost:8090/v1/patches/bulk \
  --header 'Content-Type: application/json' \
  --data '{ "patches": [ { "patchId": "example", "actor": "example", "timestamp": "2026-04-15T12:00:00Z", "source": { "uri": "example", "sourceHash": "example", "extractor": "example", "sourceType": "example", "workspaceId": "example" }, "baseRev": 1, "ops": [ { "type": "example" } ], "replaces": [ "example" ], "intent": "example" } ] }'

• Local backend (Docker memory-layer)
• Compass visualizer (proxies /v1 to the backend)

Request Body^required

Media typeapplication/json

object

patches

required

Array<object>

object

patchId

required

string

actor

required

string

timestamp

required

string format: date-time

source

required

object

uri

required

Workspace-relative path; opaque join key

string

sourceHash

string

extractor

required

string

sourceType

required

string

workspaceId

SHA-256 of the workspace root path

string

baseRev

required

integer

ops

required

Array<object>

object

type

required

string

key

additional properties

any

replaces

required

Array<string>

intent

string

Example^generated

{
  "patches": [
    {
      "patchId": "example",
      "actor": "example",
      "timestamp": "2026-04-15T12:00:00Z",
      "source": {
        "uri": "example",
        "sourceHash": "example",
        "extractor": "example",
        "sourceType": "example",
        "workspaceId": "example"
      },
      "baseRev": 1,
      "ops": [
        {
          "type": "example"
        }
      ],
      "replaces": [
        "example"
      ],
      "intent": "example"
    }
  ]
}

Responses

200

Commit results

Media typeapplication/json

Array<object>

object

status

string

rev

integer

Example^generated

[
  {
    "status": "example",
    "rev": 1
  }
]