---
title: "Create Github Repo"
method: POST
path: "/api/github/repos/create"
tags: ["github"]
---

# Create Github Repo

`POST /api/github/repos/create`

## Request

- Base URL: `https://app.getdot.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.getdot.ai/api/github/repos/create`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in cookie `Authorization`
  - OAuth 2 (password, token URL `/api/auth/token`)

Create a new private GitHub repository and push existing state.

Creates the repo, configures it as the sync target, and pushes all existing
model files (notes, data sources, relationships) to the new repository.

Args:
    name: Repository name (letters, numbers, hyphens, underscores, dots)
    description: Optional repository description

## Request body

- BodyCreateGithubRepoApiGithubReposCreatePost
  - `name` string, required
  - `description` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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