List repos
List repos for an organization.
Repos are paginated.
- The response includes pagination information and the list of repos.
- The list of repos is sorted by the repo name; sort_direction selects the direction (asc = A–Z, the default; desc = Z–A).
- Optional filters: name (exact match), search (case-insensitive substring match on the name), provider (VCS provider), repo_id (external repo ID), vcs_instance (VCS host, exact match), namespace (namespace prefix), and tag (key or key:value, repeatable).
- name and search are mutually exclusive; providing both returns a 400.
- repo_id is the stronger identifier as names of repos can change. So if repo_id is provided, name is ignored.
Repos are captured when attestations include a reference to a repo. This happens automatically when using Kosli CLI v2.11.35 or higher.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Page number
x >= 1Number of repos per page
1 <= x <= 50Filter by repo name (exact match). This is ignored if repo_id is provided. Returns empty list if no match. Mutually exclusive with search.
Filter by repo name (case-insensitive substring match). Mutually exclusive with name.
Filter by VCS provider (e.g. github, gitlab, bitbucket, azure-devops, circleci).
github, gitlab, bitbucket, bitbucket_cloud, bitbucket_dc, azure-devops, azure_devops_services, azure_devops_server, circleci, git, subversion Filter by external repo ID (exact match). Returns empty list if no match.
Filter by VCS instance/host (exact match), e.g. gitlab.company.com.
Filter by namespace prefix, as a '/'-separated path, e.g. platform/backend. Matches repos nested anywhere under that path.
Sort direction by repo name: asc (A–Z, default) or desc (Z–A).
asc, desc Filter by tag key or key:value. Can be repeated, e.g. tag=team or tag=team:security.