---
title: "Создать редактируемую ветку экрана"
method: POST
path: "/screen/branch"
tags: ["screens"]
---

# Создать редактируемую ветку экрана

`POST /screen/branch`

## Request

- Base URL: `https://maketa.pro/maketa/api`
- URL: `https://maketa.pro/maketa/api/screen/branch`
- Auth: one of:
  - none
  - API key in header `x-maketa-key`

Право: edit-токен (поле edit), сессия владельца или песочный ключ своей доски (x-maketa-key). Проектный ключ mk_pk_ ветку НЕ создаёт (push-only) — ответ 403 forbidden_for_project_key. Для code-экранов ветка — единственный способ правки.

## Request body

- object
  - `id` string, required
  - `screenId` string, required
  - `edit` string
  - `name` string

## Response `200`

Ветка создана

- object
  - `ok` boolean
  - `screenId` string
  - `parentId` string

## Other responses

- `400`: Некорректный запрос
- `401`: Нет или неверный/просроченный ключ (bad_key | key_expired | no_key). hint подскажет, как получить новый.
- `402`: plan_limit — предел тарифа (только при включённых тарифах, MAKETA_PLANS=1). limit: boards | screens | bytes | collaborators | flex | mcpKeys | mcpWrite | seats; used/max — числа; upgrade — какой тариф снимает предел (pro | studio | null); hint — подсказка по-русски. Просмотр по ссылке, экспорт экрана и чтение через API не ограничиваются никогда.
- `403`: Прав нет (forbidden | quota_boards)
- `404`: Не существует (not_found)
- `409`: too_many_screens
- `410`: Удалено навсегда (gone) — с deletedAt и reason

---

[API](https://skmtc.dev/maketa/apis/maketa-api.md) · [All operations](https://skmtc.dev/maketa/apis/maketa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maketa/apis/maketa-api/revisions/ef044d6259d8?raw)