BizKitHub
DocsAPI ReferenceBranch/bff/branch/update
postBranchAdmin BFF

/bff/branch/update

Updates editable fields of a branch. Only provided fields are changed; undefined fields are preserved. Null values explicitly clear nullable fields.

BranchpostBffBranchUpdate

Parameters

JSON body

Request body

application/json
slugstringRequired

Branch slug (used to identify the branch).

Exampleprague-central
namestringOptional

New branch display name.

Length: 1
descriptionstring | nullOptional
One of 2:
Variant 1
string

New description. Null to clear.

Variant 2
null
internalCodestring | nullOptional
One of 2:
Variant 1
string

Internal code (unique per org). Null to clear.

Variant 2
null
urlstring | nullOptional
One of 2:
Variant 1
string

Public URL. Null to clear.

Variant 2
null
activebooleanOptional

Whether the branch is active.

latitudenumber | nullOptional
One of 2:
Variant 1
number

GPS latitude.

Variant 2
null
longitudenumber | nullOptional
One of 2:
Variant 1
number

GPS longitude.

Variant 2
null
branchContactIdstring | nullOptional
One of 2:
Variant 1
string

CuRefNo of the contact representing the branch itself (technical mail / accounting target). Null to unlink.

Variant 2
null
establishedDatestring | nullOptional
One of 2:
Variant 1
string

Legal incorporation / business-registry date (ISO timestamp). Null clears.

Variant 2
null
openedDatestringOptional

Date the branch started serving customers (ISO timestamp). Drives the financial roll-up bucket key. Cannot be null — every branch must have an opened date.

Length: 1
branchType"own" | "franchise" | "partner"Optional

Branch kind. Cannot be null — defaults to "own" if never set.

parentBranchSlugstring | nullOptional
One of 2:
Variant 1
string

Slug of the operational parent branch. Null detaches. Setting a slug that would create a cycle is rejected.

Variant 2
null
operatingCompanyContactRefstring | nullOptional
One of 2:
Variant 1
string

CuRefNo of the contact representing the legal entity operating this branch. Null unlinks (admin then shows a missing-operator warning).

Variant 2
null

Response schema

1 status code documented

200Success
successbooleanRequired
slugstringRequired

Response example

application/json
{
  "success": false,
  "slug": "example_slug"
}

Request example

POST /bff/branch/update

post
curl -X POST "https://api.bizkithub.com/bff/branch/update" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "slug": "prague-central",
  "name": "example_name",
  "active": false,
  "openedDate": "example_openedDate"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key