LLM-based three-way merge of a user edit with the current LLM output

Semantic auto-merge for a single file.

Uses Claude to combine the user’s saved content with the fresh LLM baseline: preserve user framing, absorb new facts. Saves the result as an updated content edit and returns the refreshed tree.

Only works on DRAFT trees that have an active content edit and a captured LLM baseline for the path.

POST /context-documents/tree/{tree_id}/files/automerge

LLM-based three-way merge of a user edit with the current LLM output

cURL

curl --request POST \
  --url https://api.hyperspell.com/context-documents/tree/{tree_id}/files/automerge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "<string>"
}
'

200

{
  "tree_id": "<string>",
  "status": "<string>",
  "version": 123,
  "files": [
    {
      "path": "<string>",
      "content": "<string>",
      "tier": "<string>",
      "team": "<string>",
      "updated_at": "<string>"
    }
  ],
  "error": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "meta": {}
}

Authorizations

APIKeyAsUser

Authorization · string · header · required

API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.

Path Parameters

tree_id · string · required

Body

application/json

path · string · required

File path to auto-merge.

Response

200

application/json

Successful Response

tree_id · string · required

status · string · required

version · integer · required

files · TreeFile · object[] | null · required

Show child attributes

error · string | null · required

created_at · string<date-time> · required

completed_at · string<date-time> | null · required

meta · Meta · object · required