LogoFreestyle
API Reference/Git

Create a repository

Create a repository. Once the repository is created, it will also be created on the Git server. The repository name must be unique within your account. Once created, you can then push your code to this repository. The repo will be available at `git.freestyle.sh/{repo-id}`

POST
/git/v1/repo

Request Body

application/jsonRequired
namestring | null

This name is not visible to users, and is only accessible to you via API and in the dashboard. Mostly useful for observability.

publicboolean
Default: false
defaultBranchstring | null

The default branch name for the repository. Defaults to "main" if not specified.

sourceobject

Fork from another Git repository. Cannot be used with import.

importFiles | Tar | Zip | Git

Import static content with an initial commit. Cannot be used with source.

devServersobject

Response Body

200

Repository created successfully

repoIdRequiredstring
Format: "uuid"

500

Error: InternalServerError

errorRequiredstring

Error code in SCREAMING_SNAKE_CASE

messageRequiredstring

Human-readable error message

curl -X POST "https://api.freestyle.sh/git/v1/repo" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "public": false,
    "defaultBranch": "string",
    "source": {
      "url": "http://example.com",
      "branch": "string",
      "depth": 0
    },
    "import": {
      "files": {
        "property1": "string",
        "property2": "string"
      },
      "commitMessage": "string",
      "authorName": "string",
      "authorEmail": "string",
      "type": "files"
    },
    "devServers": {
      "devCommand": "npm run dev",
      "installCommand": "npm install",
      "timeout": 30,
      "envVars": {
        "RESEND_API_KEY": "re_123456789"
      },
      "ports": [
        {
          "externalPort": 443,
          "targetPort": 3000
        }
      ],
      "preset": {},
      "systemd": {},
      "users": [
        {
          "name": "string",
          "uid": 0,
          "gecos": "string",
          "groups": [
            "string"
          ],
          "home": "string",
          "shell": "string",
          "system": false
        }
      ],
      "groups": [
        {
          "name": "string",
          "gid": 0,
          "system": false
        }
      ],
      "additionalFiles": {
        "property1": {
          "content": "string",
          "encoding": "string"
        },
        "property2": {
          "content": "string",
          "encoding": "string"
        }
      },
      "webTerminal": true,
      "webVscode": true,
      "additionalRepositories": [
        {
          "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0",
          "path": "string"
        }
      ]
    }
  }'

Repository created successfully

{
  "repoId": "c7c90052-c566-40b6-94a5-a1e9a44bfdc7"
}

Create a Git identity POST

Create a Git identity. This identity will be used to authenticate with the Git server.

Delete a git trigger DELETE

Delete a git trigger. This is irreversible.

Freestyle AI

Documentation assistant

Experimental: AI responses may not always be accurate—please verify important details with the official documentation.

How can I help?

Ask me about Freestyle while you browse the docs.