client.repo
Generated methods for the repo namespace.
Sync owner: WarmHubClient.repo. Async owner: AsyncWarmHubClient.repo.
Synchronous methods
Section titled “Synchronous methods”archive
Section titled “archive”archive(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.archive — mutate repo.archive.
create
Section titled “create”create(org_name: str, repo_name: str, description: str | Unset = UNSET, visibility: Literal['public', 'private'] | Unset = UNSET, display_name: str | Unset = UNSET, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.create — mutate repo.create.
delete
Section titled “delete”delete(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)repo.delete — mutate repo.delete. Soft-delete a repository.
The repository is hidden immediately and scheduled for permanent purge after a 30-day grace window. The backend refuses the delete while another repository still has inbound cross-repo references, active subscriptions, or active credential grants depending on this one.
grace_expires_at on the result is the epoch-millisecond int the
server sent, not a datetime.
describe
Section titled “describe”describe(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoDescribeResultrepo.describe — query repo.describe.
explore
Section titled “explore”explore(*, search: str | Unset = UNSET, org: str | Unset = UNSET, activity: Literal['week', 'month'] | Unset = UNSET, has_subscriptions: Literal[True] | Unset = UNSET, min_things: float | Unset = UNSET, sort: Literal['recentlyUpdated', 'mostSubscribed', 'mostThings', 'nameAsc', 'newest'] | Unset = UNSET, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, slugs: Sequence[str] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoExploreResultrepo.explore — query repo.explore.
explore_iter
Section titled “explore_iter”explore_iter(*, search: str | Unset = UNSET, org: str | Unset = UNSET, activity: Literal['week', 'month'] | Unset = UNSET, has_subscriptions: Literal[True] | Unset = UNSET, min_things: float | Unset = UNSET, sort: RepoExploreSort | Unset = UNSET, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, slugs: Sequence[str] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every public Explore browse result, page by page. No auth required.
slugs mode is not pageable and raises VALIDATION_ERROR
before any request — the guard runs in the factory, not inside the
iterator.
total and the orgs facet are first-page-only fields on the
underlying result; iterating yields items, so neither is observable
here. Call explore directly when you need them.
get(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.get — query repo.get.
get_agents
Section titled “get_agents”get_agents(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> WireThingDetail | Nonerepo.getAgents — query repo.getAgents.
get_configure_stats
Section titled “get_configure_stats”get_configure_stats(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoConfigureStatsrepo.getConfigureStats — query repo.configureStats.
get_license
Section titled “get_license”get_license(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoLicense | Nonerepo.getLicense — query repo.getLicense.
get_llms_txt
Section titled “get_llms_txt”get_llms_txt(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> SynthesizedRepoContentrepo.getLlmsTxt — query repo.getLlmsTxt.
get_readme
Section titled “get_readme”get_readme(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> WireThingDetail | Nonerepo.getReadme — query repo.getReadme.
get_shape_instance_counts
Section titled “get_shape_instance_counts”get_shape_instance_counts(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> JsonValuerepo.getShapeInstanceCounts — query repo.shapeInstanceCounts.
get_stats
Section titled “get_stats”get_stats(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoStatsrepo.getStats — query repo.stats.
get_stats_batch
Section titled “get_stats_batch”get_stats_batch(org_name: str, repo_names: Sequence[str], *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoStatsBatchResultrepo.getStatsBatch — query repo.statsBatch.
list(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: Literal['newest', 'oldest', 'nameAsc', 'nameDesc'] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoListResultrepo.list — query repo.list.
list_for_caller
Section titled “list_for_caller”list_for_caller(*, limit: float | Unset = UNSET, sort: Literal['recent', 'name'] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> tuple[RepoForCaller, ...]repo.listForCaller — query repo.listForCaller.
list_iter
Section titled “list_iter”list_iter(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: RepoListSort | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every repository in the org, page by page. for repo in ....
list_page
Section titled “list_page”list_page(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: Literal['newest', 'oldest', 'nameAsc', 'nameDesc'] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoListPageResultrepo.listPage — query repo.listPage.
list_page_iter
Section titled “list_page_iter”list_page_iter(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: RepoListSort | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every repository row with stats, page by page.
The dashboard-oriented twin of list_iter: same filters, rows
carrying exact active counts, last_write_at and has_errors.
rename
Section titled “rename”rename(org_name: str, repo_name: str, new_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.rename — mutate repo.rename.
search
Section titled “search”search(query: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> GlobalSearchResultrepo.search — query repo.search.
search_iter
Section titled “search_iter”search_iter(query: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every global repository search hit, page by page.
Searches across all orgs: public repositories plus private ones the caller can read.
set_agents
Section titled “set_agents”set_agents(org_name: str, repo_name: str, content: str, *, event_request_id: str, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> CommitApplyCompatibilityResult0 | CommitApplyCompatibilityResult1repo.setAgents — mutate repo.setAgents.
set_description
Section titled “set_description”set_description(org_name: str, repo_name: str, description: str | Unset = UNSET, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.setDescription — mutate repo.setDescription.
set_display_name
Section titled “set_display_name”set_display_name(org_name: str, repo_name: str, display_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.setDisplayName — mutate repo.setDisplayName.
set_readme
Section titled “set_readme”set_readme(org_name: str, repo_name: str, content: str, *, event_request_id: str, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> CommitApplyCompatibilityResult0 | CommitApplyCompatibilityResult1repo.setReadme — mutate repo.setReadme.
set_visibility
Section titled “set_visibility”set_visibility(org_name: str, repo_name: str, visibility: Literal['public', 'private'], *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.setVisibility — mutate repo.setVisibility.
unarchive
Section titled “unarchive”unarchive(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.unarchive — mutate repo.unarchive.
update
Section titled “update”update(payload: Mapping[str, JsonValue], *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.update — mutate repo.update.
Asynchronous methods
Section titled “Asynchronous methods”archive
Section titled “archive”archive(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.archive — mutate repo.archive.
create
Section titled “create”create(org_name: str, repo_name: str, description: str | Unset = UNSET, visibility: Literal['public', 'private'] | Unset = UNSET, display_name: str | Unset = UNSET, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.create — mutate repo.create.
delete
Section titled “delete”delete(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)repo.delete — mutate repo.delete. Soft-delete a repository.
The repository is hidden immediately and scheduled for permanent purge after a 30-day grace window. The backend refuses the delete while another repository still has inbound cross-repo references, active subscriptions, or active credential grants depending on this one.
grace_expires_at on the result is the epoch-millisecond int the
server sent, not a datetime. See the module docstring: TypeScript’s
new Date(...) wrap is a JS-side ergonomic, and every timestamp in
this package is wire-typed.
describe
Section titled “describe”describe(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoDescribeResultrepo.describe — query repo.describe.
explore
Section titled “explore”explore(*, search: str | Unset = UNSET, org: str | Unset = UNSET, activity: Literal['week', 'month'] | Unset = UNSET, has_subscriptions: Literal[True] | Unset = UNSET, min_things: float | Unset = UNSET, sort: Literal['recentlyUpdated', 'mostSubscribed', 'mostThings', 'nameAsc', 'newest'] | Unset = UNSET, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, slugs: Sequence[str] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoExploreResultrepo.explore — query repo.explore.
explore_iter
Section titled “explore_iter”explore_iter(*, search: str | Unset = UNSET, org: str | Unset = UNSET, activity: Literal['week', 'month'] | Unset = UNSET, has_subscriptions: Literal[True] | Unset = UNSET, min_things: float | Unset = UNSET, sort: RepoExploreSort | Unset = UNSET, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, slugs: Sequence[str] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every public Explore browse result, page by page. No auth required.
slugs mode is not pageable and raises VALIDATION_ERROR
before any request — the guard runs in the factory, not inside the
iterator, so it fires on the call that named slugs rather than on
whichever page a caller happens to pull first.
total and the orgs facet are first-page-only fields on the
underlying result; iterating yields items, so neither is observable
here. Call explore directly when you need them.
get(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.get — query repo.get.
get_agents
Section titled “get_agents”get_agents(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> WireThingDetail | Nonerepo.getAgents — query repo.getAgents.
get_configure_stats
Section titled “get_configure_stats”get_configure_stats(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoConfigureStatsrepo.getConfigureStats — query repo.configureStats.
get_license
Section titled “get_license”get_license(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoLicense | Nonerepo.getLicense — query repo.getLicense.
get_llms_txt
Section titled “get_llms_txt”get_llms_txt(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> SynthesizedRepoContentrepo.getLlmsTxt — query repo.getLlmsTxt.
get_readme
Section titled “get_readme”get_readme(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> WireThingDetail | Nonerepo.getReadme — query repo.getReadme.
get_shape_instance_counts
Section titled “get_shape_instance_counts”get_shape_instance_counts(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> JsonValuerepo.getShapeInstanceCounts — query repo.shapeInstanceCounts.
get_stats
Section titled “get_stats”get_stats(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoStatsrepo.getStats — query repo.stats.
get_stats_batch
Section titled “get_stats_batch”get_stats_batch(org_name: str, repo_names: Sequence[str], *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoStatsBatchResultrepo.getStatsBatch — query repo.statsBatch.
list(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: Literal['newest', 'oldest', 'nameAsc', 'nameDesc'] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoListResultrepo.list — query repo.list.
list_for_caller
Section titled “list_for_caller”list_for_caller(*, limit: float | Unset = UNSET, sort: Literal['recent', 'name'] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> tuple[RepoForCaller, ...]repo.listForCaller — query repo.listForCaller.
list_iter
Section titled “list_iter”list_iter(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: RepoListSort | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every repository in the org, page by page. async for repo in ....
list_page
Section titled “list_page”list_page(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: Literal['newest', 'oldest', 'nameAsc', 'nameDesc'] | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoListPageResultrepo.listPage — query repo.listPage.
list_page_iter
Section titled “list_page_iter”list_page_iter(org_name: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, include_archived: bool | Unset = UNSET, search: str | Unset = UNSET, sort: RepoListSort | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every repository row with stats, page by page.
The dashboard-oriented twin of list_iter: same filters, rows
carrying exact active counts, last_write_at and has_errors.
rename
Section titled “rename”rename(org_name: str, repo_name: str, new_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.rename — mutate repo.rename.
search
Section titled “search”search(query: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> GlobalSearchResultrepo.search — query repo.search.
search_iter
Section titled “search_iter”search_iter(query: str, *, limit: float | Unset = UNSET, cursor: str | Unset = UNSET, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET)Every global repository search hit, page by page.
Searches across all orgs: public repositories plus private ones the caller can read.
set_agents
Section titled “set_agents”set_agents(org_name: str, repo_name: str, content: str, *, event_request_id: str, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> CommitApplyCompatibilityResult0 | CommitApplyCompatibilityResult1repo.setAgents — mutate repo.setAgents.
set_description
Section titled “set_description”set_description(org_name: str, repo_name: str, description: str | Unset = UNSET, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.setDescription — mutate repo.setDescription.
set_display_name
Section titled “set_display_name”set_display_name(org_name: str, repo_name: str, display_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.setDisplayName — mutate repo.setDisplayName.
set_readme
Section titled “set_readme”set_readme(org_name: str, repo_name: str, content: str, *, event_request_id: str, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> CommitApplyCompatibilityResult0 | CommitApplyCompatibilityResult1repo.setReadme — mutate repo.setReadme.
set_visibility
Section titled “set_visibility”set_visibility(org_name: str, repo_name: str, visibility: Literal['public', 'private'], *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.setVisibility — mutate repo.setVisibility.
unarchive
Section titled “unarchive”unarchive(org_name: str, repo_name: str, *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.unarchive — mutate repo.unarchive.
update
Section titled “update”update(payload: Mapping[str, JsonValue], *, extra_headers: ExtraHeaders | Unset = UNSET, extra_query: ExtraQuery | Unset = UNSET, extra_body: ExtraBody | Unset = UNSET) -> RepoInforepo.update — mutate repo.update.