Create

client.vals.branches.create(, , ?): BranchCreateResponse { id, createdAt, forkedBranchId, 4 more }

post/v2/vals/{val_id}/branches

Create a new branch

ParametersExpand Collapse

valID: string

body: BranchCreateParams { name, branchId }

name: string

branchId?: string

The branch ID to fork from. If this is not specified, the new branch will be forked from main.

formatuuid

ReturnsExpand Collapse

BranchCreateResponse { id, createdAt, forkedBranchId, 4 more }

A Branch

id: string

The id of the branch

formatuuid

createdAt: string

forkedBranchId: string | null

The id of the branch this branch was forked from

links: Links { html, self }

html: string

The URL of this resource on Val Town

formaturi

self: string

The URL of this resource on this API

formaturi

name: string

updatedAt: string

version: number

import ValTown from "npm:@valtown/sdk";

const client = new ValTown();

const branch = await client.vals.branches.create('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', {
  name: 'my-branch',
  branchId: '00000000-0000-0000-0000-000000000000',
});

console.log(branch.id);

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "createdAt": "2019-12-27T18:11:19.117Z",
  "forkedBranchId": "forkedBranchId",
  "links": {
    "html": "https://example.com",
    "self": "https://example.com"
  },
  "name": "name",
  "updatedAt": "2019-12-27T18:11:19.117Z",
  "version": 0
}

Returns Examples

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "createdAt": "2019-12-27T18:11:19.117Z",
  "forkedBranchId": "forkedBranchId",
  "links": {
    "html": "https://example.com",
    "self": "https://example.com"
  },
  "name": "name",
  "updatedAt": "2019-12-27T18:11:19.117Z",
  "version": 0
}