Create repository

POST /api/v1/repos

Creates a new repository in your organization, with optional links to an external mirror or fork from an existing repository. The repository identifier is taken from the JWT repo claim (not the request body).

Basic Usage

POST /api/v1/repos
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "default_branch": "main"  // Optional, defaults to "main"
}

With GitHub Sync

POST /api/v1/repos
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "default_branch": "main",
  "base_repo": {
    "provider": "github",
    "owner": "org-name",
    "name": "repo-name",
    "default_branch": "main"
  }
}

With Forking

Fork from an existing Code Storage repository:

POST /api/v1/repos
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "base_repo": {
    "provider": "code.storage",
    "name": "source-repo",
    "operation": "fork",
    "ref": "main",              // Optional: branch to fork from
    "auth": {
      "token": "JWT_WITH_READ_ACCESS_TO_SOURCE"
    }
  }
}

Request Body

Parameter	Type	Description
default_branch	Optional	Default branch name for the Code Storage repository (defaults to “main”)
base_repo	Optional	Configuration for GitHub sync or forking (see below)

BaseRepo for GitHub Sync

Property	Type	Description
provider	Required	Set to "github"
owner	Required	GitHub organization or username
name	Required	GitHub repository name
default_branch	Optional	GitHub repository’s default branch

BaseRepo for Forking

Property	Type	Description
provider	Required	Set to "code" or "code.storage"
owner	Optional	Ignored for code.storage providers
name	Required	Source repository URL (name) to fork from
operation	Required	Set to "fork"
ref	Optional	Branch or tag name to fork from
sha	Optional	Exact commit SHA to fork at (overrides ref)
auth.token	Required	JWT with git:read scope for the source repository

JWT Requirements

• Requires the repo:write scope for the new repository
• For forking, base_repo.auth.token must have git:read scope for the source repository

Response

{
  "repo_id": "V1StGXR8_Z5jdHi6B-myT",
  "http_url": "team/project-alpha",
  "message": "Repository 'V1StGXR8_Z5jdHi6B-myT' created successfully"
}

Error Responses

Status	Description
401 Unauthorized	Invalid JWT or missing required scope
409 Conflict	Repository already exists