argocd.repository.create-repository ​
CreateRepository creates a new 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 |
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. |
upsert | boolean | No | — | Whether to create in upsert mode. |
credsonly | boolean | No | — | Whether to operate on credential set instead of repository. |
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 |
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. |
upsert | boolean | No | — | Whether to create in upsert mode. |
credsonly | boolean | No | — | Whether to operate on credential set instead of repository. |
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 POST /api/v1/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 POST /api/v1/repositories |
* (any state) | fail | failed | Record the failure reason |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "argocd.repository.create-repository",
"initial_data": {
"base_url": "value"
}
}