Chelabase
ManagementMerges

Read a merge

GET
/v1/databases/{id}/merges/{merge_id}

The merge with its analysis (every changed object, the conflicts with base, target and source side by side), the plan, the last rehearsal, the result and the log. Poll it while the status is computing, rehearsing, applying, online or finishing, and while a requested after-merge choice is pending (result.after.requested or started).

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Database id

Formatuuid
merge_id*string

Merge id

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/databases/497f6eca-6276-4993-bfeb-53cbbbba6f08/merges/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "events": [    {      "at": "2019-08-24T14:15:22Z",      "detail": {},      "duration_ms": 0,      "kind": "string",      "outcome": "string",      "phase": "string",      "step_id": "string"    }  ],  "merge": {    "acknowledgements": [      "string"    ],    "analysis": {},    "base_fingerprint": "string",    "created_at": "2019-08-24T14:15:22Z",    "created_by": "string",    "database": "string",    "direction": "into_parent",    "error": "string",    "failed_phase": "string",    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "options": {},    "plan": {},    "rebaselined": true,    "rehearsal": {},    "resolutions": [      {        "choice": "keep_target",        "conflict": "string"      }    ],    "result": {},    "source_branch_id": "345f76de-8f9d-4a8f-b08e-a28a3db17483",    "source_fingerprint": "string",    "status": "computing",    "steps": [      {        "after": "string",        "id": "string",        "sql": "string"      }    ],    "target_branch_id": "2a8880d3-8c08-4fef-81e0-ec9d6c6def29",    "target_fingerprint": "string",    "updated_at": "2019-08-24T14:15:22Z",    "version": 0  }}

List a database's merges GET

History and open merges, newest first, without their analysis and plan (read one with `getMerge`).

Edit a draft merge PATCH

Saves the resolutions, own steps, acknowledgements and options of a `draft` or `rehearsed` merge. A save of only `acknowledgements` and `options.after` keeps the merge as it is (a rehearsed merge stays rehearsed). Any other save (resolutions, steps, `options.lock_timeout_ms`) moves it to `computing` (a rehearsed one loses its rehearsal): the worker recomputes the analysis and the plan from what was saved, keeping a resolution whose conflict is unchanged, and returns it to `draft`. `version` must be the one you last read.