createRepo()

Create a new repository with optional custom ID, default branch, Git Sync configuration, or a fork from an existing repository.

TypeScript

// Basic repository creation (defaults to 'main' branch)
const repo = await store.createRepo();

// With custom ID
const repo = await store.createRepo({
  id: 'my-custom-repo',
});

// With custom default branch
const repo = await store.createRepo({
  id: 'my-custom-repo',
  defaultBranch: 'develop',
});

// With namespacing
const repo = await store.createRepo({
  id: 'production/api-service',
  defaultBranch: 'production',
});

// Fork from existing repository
const fork = await store.createRepo({
  id: 'my-fork',
  baseRepo: {
    id: 'source-repo', // Repository to fork from
    ref: 'main', // Optional: branch to fork from
  },
});

Options

id · string

Repository ID. If not provided, a UUID will be auto-generated. Supports namespacing with / (e.g., team/project-alpha).

defaultBranch · string

Default branch name for the repository. Defaults to main, or to the source repository’s default branch when baseRepo forks an existing repository.

baseRepo · object

Configuration for Git Sync or forking from an existing repository. See below for structure.

ttl · string

Token TTL for this invocation in seconds. Defaults to 1 hour when omitted for this call.

BaseRepo for Git Sync

Use this structure to sync with a GitHub repository:

owner · string · required

GitHub repository owner (username or organization).

name · string · required

GitHub repository name.

defaultBranch · string

GitHub repository’s default branch.

When baseRepo contains owner and name, Code Storage links the repository to an external Git provider for syncing. See the GitHub Sync guide for details.

Generic Git providers such as GitLab, Bitbucket, Gitea, Forgejo, Codeberg, and SourceHut use the same repository creation flow at the HTTP API layer. After creating the repo, configure credentials with Git credentials.

BaseRepo for Forking

Use this structure to fork from an existing Code Storage repository:

id · string · required

The source repository ID to fork from.

ref · string

Branch or tag name to fork from. Forks the tip of this ref.

sha · string

Exact commit SHA to fork at. Overrides ref if both are provided.

Resolution order:

1. If sha is provided, fork at that exact commit
2. If ref is provided, fork at the tip of that branch/tag
3. Otherwise, fork at the source repository’s HEAD

The fork inherits the source repository’s default branch. Set defaultBranch on the request to override it.

When baseRepo contains id, a fork is created from the specified repository. See the Repository Forks guide for details.

Response

Returns a Repository instance with the following properties:

id · string

The repository identifier

defaultBranch · string

The repository’s default branch name (e.g., main)

The returned repository instance also provides methods for managing branches, commits, files, and more. See the other SDK reference pages for details.