argocd.repository.update-write-repository ​
UpdateWriteRepository updates a write repository configuration
Overview ​
| Property | Value |
|---|---|
| Workflow type | Atomic |
| Library | App-argocd |
| Version | 1.0 |
Input Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
base_url | string | Yes | — | Argocd API root, e.g. https://<host>/api |
api_token | string | No | — | Bearer token; omit to use the workflow's token env var |
repo_repo | string | Yes | — | Repo contains the URL to the remote repository |
azureactivedirectoryendpoint | string | No | — | — |
azureserviceprincipalclientid | string | No | — | — |
azureserviceprincipalclientsecret | string | No | — | — |
azureserviceprincipaltenantid | string | No | — | — |
bearertoken | string | No | — | — |
connectionstate | json | No | — | — |
depth | integer | No | — | Depth specifies the depth for shallow clones. A value of 0 or omitting the field indicates a full clone. |
enablelfs | boolean | No | — | EnableLFS specifies whether git-lfs support should be enabled for this repo. Only valid for Git repositories. |
enableoci | boolean | No | — | — |
forcehttpbasicauth | boolean | No | — | — |
gcpserviceaccountkey | string | No | — | — |
githubappenterprisebaseurl | string | No | — | — |
githubappid | integer | No | — | — |
githubappinstallationid | integer | No | — | — |
githubappprivatekey | string | No | — | — |
inheritedcreds | boolean | No | — | — |
insecure | boolean | No | — | — |
insecureignorehostkey | boolean | No | — | — |
insecureociforcehttp | boolean | No | — | InsecureOCIForceHttp specifies whether the connection to the repository uses TLS at all. If true, no TLS. This flag is applicable for OCI repos only. |
name | string | No | — | — |
noproxy | string | No | — | — |
password | string | No | — | — |
project | string | No | — | — |
proxy | string | No | — | — |
repo | string | No | — | — |
sshprivatekey | string | No | — | SSHPrivateKey contains the PEM data for authenticating at the repo server. Only used with Git repos. |
tlsclientcertdata | string | No | — | — |
tlsclientcertkey | string | No | — | — |
type | string | No | — | Type specifies the type of the repo. Can be either "git" or "helm. "git" is assumed if empty or absent. |
useazureworkloadidentity | boolean | No | — | — |
username | string | No | — | — |
webhookmanifestcachewarmdisabled | boolean | No | — | 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. |
Output Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
base_url | string | Yes | — | Argocd API root, e.g. https://<host>/api |
api_token | string | No | — | Bearer token; omit to use the workflow's token env var |
repo_repo | string | Yes | — | Repo contains the URL to the remote repository |
azureactivedirectoryendpoint | string | No | — | — |
azureserviceprincipalclientid | string | No | — | — |
azureserviceprincipalclientsecret | string | No | — | — |
azureserviceprincipaltenantid | string | No | — | — |
bearertoken | string | No | — | — |
connectionstate | json | No | — | — |
depth | integer | No | — | Depth specifies the depth for shallow clones. A value of 0 or omitting the field indicates a full clone. |
enablelfs | boolean | No | — | EnableLFS specifies whether git-lfs support should be enabled for this repo. Only valid for Git repositories. |
enableoci | boolean | No | — | — |
forcehttpbasicauth | boolean | No | — | — |
gcpserviceaccountkey | string | No | — | — |
githubappenterprisebaseurl | string | No | — | — |
githubappid | integer | No | — | — |
githubappinstallationid | integer | No | — | — |
githubappprivatekey | string | No | — | — |
inheritedcreds | boolean | No | — | — |
insecure | boolean | No | — | — |
insecureignorehostkey | boolean | No | — | — |
insecureociforcehttp | boolean | No | — | InsecureOCIForceHttp specifies whether the connection to the repository uses TLS at all. If true, no TLS. This flag is applicable for OCI repos only. |
name | string | No | — | — |
noproxy | string | No | — | — |
password | string | No | — | — |
project | string | No | — | — |
proxy | string | No | — | — |
repo | string | No | — | — |
sshprivatekey | string | No | — | SSHPrivateKey contains the PEM data for authenticating at the repo server. Only used with Git repos. |
tlsclientcertdata | string | No | — | — |
tlsclientcertkey | string | No | — | — |
type | string | No | — | Type specifies the type of the repo. Can be either "git" or "helm. "git" is assumed if empty or absent. |
useazureworkloadidentity | boolean | No | — | — |
username | string | No | — | — |
webhookmanifestcachewarmdisabled | boolean | No | — | 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. |
status_code | integer | No | — | HTTP status code of the completed call |
response | json | No | — | Parsed JSON response body |
failure_reason | string | No | — | — |
failure_type | string | No | — | — |
failed_at | string | No | — | — |
failed_step | string | No | — | — |
failed_layer | string | No | — | — |
failed_at_state | string | No | — | — |
error | string | No | — | — |
error_type | string | No | — | — |
States ​
| State | Initial | Terminal | Success | Auto-advance | Description |
|---|---|---|---|---|---|
pending | Yes | No | — | execute | Waiting to call PUT /api/v1/write-repositories/ |
completed | No | Yes | Yes | — | HTTP call succeeded |
failed | No | Yes | No | — | HTTP call failed |
State Diagram ​
Transitions ​
| From | Action | To | Description |
|---|---|---|---|
pending | execute | completed | Perform PUT /api/v1/write-repositories/ |
* (any state) | fail | failed | Record the failure reason |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "argocd.repository.update-write-repository",
"initial_data": {
"base_url": "value",
"repo_repo": "value"
}
}