Upsert branch

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

Create a new branch if it doesn’t exist, or update the branch if it already exists.

PUT /api/v2/code-refs/repositories/{repo}/branches/{branch}

Upsert branch

cURL

curl --request PUT \
  --url https://app.launchdarkly.com/api/v2/code-refs/repositories/{repo}/branches/{branch} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "main",
  "head": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
  "syncTime": "1636558831870",
  "updateSequenceId": 25,
  "references": [
    {
      "path": "/main/index.js",
      "hunks": [
        {
          "startingLineNumber": 45,
          "lines": "var enableFeature = 'enable-feature';",
          "projKey": "default",
          "flagKey": "enable-feature",
          "aliases": [
            "enableFeature",
            "EnableFeature"
          ]
        }
      ],
      "hint": "javascript"
    }
  ],
  "commitTime": "1636558831870"
}
EOF

400

{
  "code": "invalid_request",
  "message": "Invalid request body"
}

Authorizations

Authorization · string · header · required

Path Parameters

repo · string<string> · required

The repository name

branch · string<string> · required

The URL-encoded branch name

Body

application/json

name · string · required

The branch name

Example:

"main"

head · string · required

An ID representing the branch HEAD. For example, a commit SHA.

Example:

"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"

syncTime · integer<int64> · required

A timestamp indicating when the branch was last synced

Example:

"1636558831870"

updateSequenceId · integer<int64>

An optional ID used to prevent older data from overwriting newer data. If no sequence ID is included, the newly submitted data will always be saved.

Example:

25

references · object[]

An array of flag references found on the branch

Show child attributes

commitTime · integer<int64>

A timestamp of the current commit

Example:

"1636558831870"

Response

200

Action succeeded