RepositoryService

CreateWriteRepository creates a new write repository configuration

POST
https://argocd.example.com/api/v1/write-repositories

Body

application/json

Repository definition

azureActiveDirectoryEndpointstring
azureServicePrincipalClientIdstring
azureServicePrincipalClientSecretstring
azureServicePrincipalTenantIdstring
bearerTokenstring
connectionStatev1alpha1ConnectionState
Show child attributes
attemptedAtv1Time<date-time>

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

+protobuf.options.marshal=false +protobuf.as=Timestamp +protobuf.options.(gogoproto.goproto_stringer)=false

messagestring
statusstring
depthinteger<int64>

Depth specifies the depth for shallow clones. A value of 0 or omitting the field indicates a full clone.

enableLfsboolean

EnableLFS specifies whether git-lfs support should be enabled for this repo. Only valid for Git repositories.

enableOCIboolean
forceHttpBasicAuthboolean
gcpServiceAccountKeystring
githubAppEnterpriseBaseUrlstring
githubAppIDinteger<int64>
githubAppInstallationIDinteger<int64>
githubAppPrivateKeystring
inheritedCredsboolean
insecureboolean
insecureIgnoreHostKeyboolean
insecureOCIForceHttpboolean

InsecureOCIForceHttp specifies whether the connection to the repository uses TLS at all. If true, no TLS. This flag is applicable for OCI repos only.

namestring
noProxystring
passwordstring
projectstring
proxystring
repostring
sshPrivateKeystring

SSHPrivateKey contains the PEM data for authenticating at the repo server. Only used with Git repos.

tlsClientCertDatastring
tlsClientCertKeystring
typestring

Type specifies the type of the repo. Can be either "git" or "helm. "git" is assumed if empty or absent.

useAzureWorkloadIdentityboolean
usernamestring
webhookManifestCacheWarmDisabledboolean

WebhookManifestCacheWarmDisabled disables manifest cache warming during webhook processing for this repository. When set, webhook handlers will only trigger reconciliation for affected applications and skip Redis cache operations for unaffected ones. Recommended for large monorepos with plain YAML manifests.

Parameters

upsertbooleanquery

Whether to create in upsert mode.

credsOnlybooleanquery

Whether to operate on credential set instead of repository.

Response

200OKv1alpha1Repository

A successful response.

Response fields application/json
azureActiveDirectoryEndpointstring
azureServicePrincipalClientIdstring
azureServicePrincipalClientSecretstring
azureServicePrincipalTenantIdstring
bearerTokenstring
connectionStatev1alpha1ConnectionState
Show child attributes
attemptedAtv1Time<date-time>

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

+protobuf.options.marshal=false +protobuf.as=Timestamp +protobuf.options.(gogoproto.goproto_stringer)=false

messagestring
statusstring
depthinteger<int64>

Depth specifies the depth for shallow clones. A value of 0 or omitting the field indicates a full clone.

enableLfsboolean

EnableLFS specifies whether git-lfs support should be enabled for this repo. Only valid for Git repositories.

enableOCIboolean
forceHttpBasicAuthboolean
gcpServiceAccountKeystring
githubAppEnterpriseBaseUrlstring
githubAppIDinteger<int64>
githubAppInstallationIDinteger<int64>
githubAppPrivateKeystring
inheritedCredsboolean
insecureboolean
insecureIgnoreHostKeyboolean
insecureOCIForceHttpboolean

InsecureOCIForceHttp specifies whether the connection to the repository uses TLS at all. If true, no TLS. This flag is applicable for OCI repos only.

namestring
noProxystring
passwordstring
projectstring
proxystring
repostring
sshPrivateKeystring

SSHPrivateKey contains the PEM data for authenticating at the repo server. Only used with Git repos.

tlsClientCertDatastring
tlsClientCertKeystring
typestring

Type specifies the type of the repo. Can be either "git" or "helm. "git" is assumed if empty or absent.

useAzureWorkloadIdentityboolean
usernamestring
webhookManifestCacheWarmDisabledboolean

WebhookManifestCacheWarmDisabled disables manifest cache warming during webhook processing for this repository. When set, webhook handlers will only trigger reconciliation for affected applications and skip Redis cache operations for unaffected ones. Recommended for large monorepos with plain YAML manifests.

defaultruntimeError

An unexpected error response.

Response fields application/json
codeinteger<int32>
detailsArray<protobufAny>
Show child attributes
type_urlstring
valuestring<byte>
errorstring
messagestring

Authorization

bearerapiKey in header

A token sent as Authorization: Bearer <token>. API Docs shows how to get one.

Docs by Sourcey
↑↓ navigate↵ selectesc close