Repository Service
Repository Service API performs CRUD actions against repository resources.Service Definition
Package:repository
Service: RepositoryService
The RepositoryService manages Git, Helm, and OCI repository configurations that Argo CD uses to fetch application manifests.
RPC Methods
ListRepositories
Gets a list of all configured repositories. Request:RepoQuery
Repo URL for query
Whether to force a cache refresh on repo’s connection state
App project for query
RepositoryList
REST Endpoint: GET /api/v1/repositories
ListWriteRepositories
Gets a list of all configured write repositories. Request:RepoQuery
Response: RepositoryList
REST Endpoint: GET /api/v1/write-repositories
Get
Returns a repository or its credentials. Request:RepoQuery
The repository URL
Whether to force a cache refresh on repo’s connection state
App project for query
Repository
REST Endpoint: GET /api/v1/repositories/{repo}
GetWrite
Returns a repository or its write credentials. Request:RepoQuery
The repository URL
Repository
REST Endpoint: GET /api/v1/write-repositories/{repo}
CreateRepository
Creates a new repository configuration. Request:RepoCreateRequest
Repository definition
Whether to create in upsert mode
Whether to operate on credential set instead of repository
Repository
REST Endpoint: POST /api/v1/repositories
CreateWriteRepository
Creates a new write repository configuration. Request:RepoCreateRequest
Response: Repository
REST Endpoint: POST /api/v1/write-repositories
UpdateRepository
Updates a repository configuration. Request:RepoUpdateRequest
Repository definition to update
Repository
REST Endpoint: PUT /api/v1/repositories/{repo.repo}
UpdateWriteRepository
Updates a write repository configuration. Request:RepoUpdateRequest
Response: Repository
REST Endpoint: PUT /api/v1/write-repositories/{repo.repo}
DeleteRepository
Deletes a repository from the configuration. Request:RepoQuery
The repository URL to delete
RepoResponse
REST Endpoint: DELETE /api/v1/repositories/{repo}
DeleteWriteRepository
Deletes a write repository from the configuration. Request:RepoQuery
Response: RepoResponse
REST Endpoint: DELETE /api/v1/write-repositories/{repo}
ValidateAccess
Validates access to a repository with given parameters. Request:RepoAccessQuery
The URL to the repo
Username for accessing repo
Password for accessing repo
Private key data for accessing SSH repository
Whether to skip certificate or host key validation
TLS client cert data for accessing HTTPS repository
TLS client cert key for accessing HTTPS repository
The type of the repo
The name of the repo
Whether helm-oci support should be enabled for this repo
Github App Private Key PEM data
Github App ID of the app used to access the repo
Github App Installation ID of the installed GitHub App
Github App Enterprise base url if empty will default to https://api.github.com
HTTP/HTTPS proxy to access the repository
Reference between project and repository
Google Cloud Platform service account key
Whether to force HTTP basic auth
RepoResponse
REST Endpoint: POST /api/v1/repositories/{repo}/validate
ValidateWriteAccess
Validates write access to a repository with given parameters. Request:RepoAccessQuery
Response: RepoResponse
REST Endpoint: POST /api/v1/write-repositories/{repo}/validate
ListRefs
Lists branches and tags in a Git repository. Request:RepoQuery
The repository URL
Refs
List of branch names
List of tag names
GET /api/v1/repositories/{repo}/refs
ListOCITags
Lists tags in an OCI repository. Request:RepoQuery
The repository URL
Refs
List of OCI tags
GET /api/v1/repositories/{repo}/oci-tags
ListApps
Returns list of apps in the repo. Request:RepoAppsQuery
The repository URL
The revision to scan
The application name
The application project
RepoAppsResponse
List of applications found in the repository
type(string): Application type (e.g., “Kustomize”, “Helm”, “Directory”)path(string): Path to the application in the repository
GET /api/v1/repositories/{repo}/apps
GetAppDetails
Returns application details by given path. Request:RepoAppDetailsQuery
The application source
The application name
The application project
Source index (for multi source apps)
Version ID from historical data (for multi source apps)
RepoAppDetailsResponse
Application type
Helm application details (if type is Helm)
Kustomize application details (if type is Kustomize)
Directory application details (if type is Directory)
Plugin application details (if type is Plugin)
POST /api/v1/repositories/{source.repoURL}/appdetails
GetHelmCharts
Returns list of helm charts in the specified repository. Request:RepoQuery
The repository URL
HelmChartsResponse
List of Helm charts
name(string): Chart nameversions(string[]): Available chart versions
GET /api/v1/repositories/{repo}/helmcharts