repos.create() - Mesa Docs

Create a repository in the current or specified organization. Required scope: write

const repo = await mesa.repos.create({ name: 'app' });

console.log(repo.name);
console.log(repo.head_change_id);

Create with an upstream Git remote:

const repo = await mesa.repos.create({
  name: 'app',
  default_bookmark: 'main',
  upstream: {
    url: 'https://github.com/acme/app.git',
    auth: { kind: 'token', token: 'github_pat_...', token_username: 'bot' },
  },
});

Options

string | undefined

Organization override.

string | undefined

Repository name. If omitted, the API generates a name.

string | undefined

Default bookmark name. Defaults to main when omitted.

Record<string, string> | undefined

String key-value repository metadata. Keys cannot start with $ (reserved for tag filter operators).

object | undefined

Optional upstream Git remote to attach at create time. On create, omitting auth and passing auth: null both create a public upstream. Pass token or username/password auth to store credentials.

Response

string

Repository ID.

string

Organization slug.

string

Repository name.

string

Default bookmark name.

string

Current change ID at the default bookmark tip.

UpstreamConfig | null

Configured upstream remote, or null when no upstream is configured.

string

Creation time.

Record<string, string>

Repository tags.

UpstreamConfig

string

Upstream Git remote URL.

'token' | 'username_password' | null

Stored upstream authentication kind, or null when the upstream is public.

​Options

​Response

​UpstreamConfig

Options

Response

UpstreamConfig