Skip to main content
List repositories using cursor pagination. Required scope: read
repos = await mesa.repos.list(limit=50)

for repo in repos.repos:
    print(repo.name, repo.default_bookmark, repo.head_change_id)

Options

org
str | None
Organization override.
cursor
str | None
Opaque pagination cursor from a previous response.
limit
int | None
Maximum number of repositories to return. The server maximum is 100.
tags
str | None
Comma-separated tag filter string such as env:prod,team:agents.

Response

next_cursor
str | None
Cursor for the next page, or null when no more results remain.
has_more
bool
Whether another page of results is available.
repos
list[Repo]
Repository objects.

Repo

id
str
Repository ID.
org
str
Organization slug.
name
str
Repository name.
default_bookmark
str
Default bookmark name.
head_change_id
str
Current change ID at the default bookmark tip.
upstream
UpstreamConfig | None
Configured upstream remote, or null when no upstream is configured.
created_at
datetime
Creation time.
tags
dict[str, str]
Repository tags.

UpstreamConfig

url
str
Upstream Git remote URL.
auth_kind
'token' | 'username_password' | None
Stored upstream authentication kind, or null when the upstream is public.