repos.create() - Mesa Docs

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

repo = await mesa.repos.create(name="app")
print(repo.name)
print(repo.head_change_id)

Create with an upstream Git remote:

from mesa_sdk.types import TokenAuth, UpstreamConfig

repo = await mesa.repos.create(
    name="app",
    default_bookmark="main",
    upstream=UpstreamConfig(
        url="https://github.com/acme/app.git",
        auth=TokenAuth(token="github_pat_...", token_username="bot"),
    ),
)

Options

str | None

Organization override.

str | None

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

str | None

Default bookmark name. Defaults to main when omitted.

UpstreamConfig | None

Optional upstream Git remote to attach at create time. On create, auth=UNSET and auth=None both create a public upstream. Pass TokenAuth or UsernamePasswordAuth to store credentials.

Response

str

Repository ID.

str

Organization slug.

str

Repository name.

str

Default bookmark name.

str

Current change ID at the default bookmark tip.

UpstreamConfig | None

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

datetime

Creation time.

dict[str, str]

Repository tags.

UpstreamConfig

str

Upstream Git remote URL.

'token' | 'username_password' | None

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

​Options

​Response

​UpstreamConfig

Options

Response

UpstreamConfig