List branches

GET

/v1/branches

const url = 'https://api.aerandil.com/v1/branches';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.aerandil.com/v1/branches \
  --header 'Authorization: Bearer <token>'

Every branch under the caller’s tenant, newest first — open and merged both (a merged row is the durable merge record). Requires objects:read.

Authorizations

aerandil_oauth

Responses

200

Branches for the tenant.

application/json

object

data

required

Array<object>

object

created_at

required

string format: date-time

forked_at_seq

required

The caller-tenant’s event-stream head seq at fork (fork-from-head only).

integer

required

string format: uuid

last_write_at

string format: date-time

merge_correlation_id

Present on a merged branch: the correlation id stamped on the branch.merged event and shared by every replayed main-log write, tying the merge record to the replayed events.

string format: uuid

merged_at

string format: date-time

name

required

string

status

required

string

Allowed values: open merged

Example

{
  "data": [
    {
      "status": "open"
    }
  ]
}

Headers

Cache-Control

string

Allowed value: no-store

Always no-store — live data.