createBranch

Create a branch on a repository asset

createBranch(
  input: CreateBranchInput!
): CreateBranchPayload

Arguments

createBranch.input ● CreateBranchInput! non-null input

Parameters for CreateBranch

Type

CreateBranchPayload object

Autogenerated return type of CreateBranch.

Example request

This generated mutation uses placeholders for required values. Replace them with values available to your API key before running it.

Before you run it

Run the assets query first and use data.assets.collection[].id as assetId.

cURL

curl --request POST https://api.convisoappsec.com/graphql \
  --header "x-api-key: $CONVISO_API_KEY" \
  --header "content-type: application/json" \
  --data '{"query":"mutation MutateCreateBranch($input: CreateBranchInput!) {\n  createBranch(input: $input) { branch { id name default } clientMutationId }\n}","variables":{"input":{"assetId":"<asset_id>","name":"example"}}}'

JavaScript

const response = await fetch('https://api.convisoappsec.com/graphql', {
  method: 'POST',
  headers: {
    'content-type': 'application/json',
    'x-api-key': process.env.CONVISO_API_KEY,
  },
  body: JSON.stringify({
    query: "mutation MutateCreateBranch($input: CreateBranchInput!) {\n  createBranch(input: $input) { branch { id name default } clientMutationId }\n}",
    variables: {
    "input": {
        "assetId": "<asset_id>",
        "name": "example"
    }
},
  }),
});

const { data, errors } = await response.json();

if (errors) throw new Error(errors.map(({ message }) => message).join(', '));
console.log(data);

Python

import json
import os
import requests

response = requests.post(
    'https://api.convisoappsec.com/graphql',
    headers={
        'content-type': 'application/json',
        'x-api-key': os.environ['CONVISO_API_KEY'],
    },
    json={
        'query': "mutation MutateCreateBranch($input: CreateBranchInput!) {\n  createBranch(input: $input) { branch { id name default } clientMutationId }\n}",
        'variables': json.loads("{\"input\":{\"assetId\":\"<asset_id>\",\"name\":\"example\"}}"),
    },
    timeout=30,
)
response.raise_for_status()

payload = response.json()
if payload.get('errors'):
    raise RuntimeError(payload['errors'])

print(payload['data'])