Argo CD
Argo CD is a GitOps continuous-delivery tool for Kubernetes. Read applications and projects, create applications, and request syncs or rollbacks from your workflows.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
Argo CD (API Token)
API token
Argo CD (API Token)
Connect to your Argo CD server to read applications and projects and create, sync, or roll back applications.
Set up in Argo CD
Ask your Argo CD administrator for a publicly reachable HTTPS API server and an expiring local-account or project-role API token. Argo CD Core does not include the required API server.
Grant application read access, application create and sync permissions for the intended project, and project read access. Confirm rollback permissions against your installed Argo CD version.
Set up in StackAI
Open Settings → Connections, add a connection, and select Argo CD (API Token).
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
Server URL
Yes
Your public HTTPS Argo CD server address, without /api.
API token
Yes
An unexpired project-role or local-account token. Grant applications get, create, and sync as needed, plus projects get for project lists. The connection check verifies sign-in; action permissions are checked when each action runs. Provider instructions.
Provider documentation: Setup reference.
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required Argo CD action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Create Application
Create an Argo CD application without deploying it.
Inputs
Application name
string
Yes
A unique name for the new application.
Project
select (string)
Yes
The project that allows this repository and destination. Options load from the selected connection.
Repository URL
string
Yes
The Git repository containing the application.
Repository path
string
Yes
Folder containing the manifests, relative to the repository root.
Target revision
string
Yes
The Git branch, tag, or commit SHA to deploy when synced.
Destination server URL
string
Yes
The registered Kubernetes cluster server URL.
Destination namespace
string
Yes
An existing namespace for the application workloads.
Application namespace
string
No
The namespace where Argo CD stores the application, which may differ from its workload namespace.
Outputs
Name
string
The application name.
Project
string
The application project.
Application namespace
string
The namespace containing the Application.
Request status
string
Application registration was accepted; no deployment was requested.
Roll Back Application
Restore a previous application deployment, with a dry run by default.
Inputs
Project
select (string)
No
Limit the application lookup to this project.
Application namespace
string
No
The namespace where Argo CD stores the application, which may differ from its workload namespace.
Application name
select (string)
Yes
Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.
History ID
select (string)
Yes
Choose a previous deployment or enter its numeric history ID. Options load from the selected connection.
Dry run
boolean
No
Preview the rollback without changing workloads. Turn off to apply changes. Default: true.
Outputs
Name
string
The application name.
Sync status
string
The sync status returned when Argo CD accepted the request. Check again to confirm completion.
Health status
string
The health status returned when Argo CD accepted the request. Check again after the operation finishes.
Operation phase
string
Left empty because the operation may still be running. Use Get Application Status to check progress.
Request status
string
Whether Argo CD accepted a preview or a deployment request. This does not confirm completion.
History ID
integer
The requested deployment history ID.
List Applications
List the Argo CD applications visible to the connected token.
Inputs
Project
select (string)
No
Optional Argo CD project name to filter applications by.
Application namespace
string
No
The namespace where Argo CD stores the application, which may differ from its workload namespace.
Max results
integer
No
Max applications to return (1-5000). Minimum: 1. Maximum: 5000.
Outputs
Applications
dict_array
Applications visible to the connected token.
Count
integer
Number of applications returned.
Truncated
boolean
Whether more results exist than the selected limit.
Get Application
Get details for a single Argo CD application.
Inputs
Project
select (string)
No
Limit the application lookup to this project.
Application namespace
string
No
The namespace where Argo CD stores the application, which may differ from its workload namespace.
Application name
select (string)
Yes
Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.
Outputs
Name
string
The application name.
Project
string
The Argo CD project the application belongs to.
Sync status
string
Whether live resources match the desired state (Synced, OutOfSync, Unknown).
Health status
string
The application's health (Healthy, Progressing, Degraded, etc.).
Repository URL
string
The Git or Helm repository URL of the application's primary source.
Target revision
string
The primary source's target revision (branch, tag, commit SHA, or chart version).
Destination namespace
string
The Kubernetes namespace the application deploys into.
Resource tree
object
Up to 200 resources with their health and parent relationships.
Deployment history
dict_array
Recent deployments available for rollback.
History truncated
boolean
Whether older deployment records were omitted.
Get Application Status
Get the sync and health status summary for an Argo CD application.
Inputs
Project
select (string)
No
Limit the application lookup to this project.
Application namespace
string
No
The namespace where Argo CD stores the application, which may differ from its workload namespace.
Application name
select (string)
Yes
Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.
Outputs
Name
string
The application name.
Sync status
string
Whether live resources match the desired state (Synced, OutOfSync, Unknown).
Health status
string
The application's health (Healthy, Progressing, Degraded, etc.).
Health message
string
A human-readable detail about the current health, if any.
Operation phase
string
Phase of the latest sync or rollback operation, or empty if none has run.
List Projects
List the Argo CD projects visible to the connected token.
Inputs
Max results
integer
No
Max projects to return (1-5000). Minimum: 1. Maximum: 5000.
Outputs
Projects
dict_array
Projects visible to the connected token.
Count
integer
Number of projects returned.
Truncated
boolean
Whether more results exist than the selected limit.
Sync Application
Preview or request a sync for an Argo CD application.
Inputs
Project
select (string)
No
Limit the application lookup to this project.
Application namespace
string
No
The namespace where Argo CD stores the application, which may differ from its workload namespace.
Application name
select (string)
Yes
Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.
Revision
string
No
Optional revision (branch, tag, commit SHA, or chart version) to sync to.
Dry run
boolean
No
Preview the sync without changing workloads. Turn off to apply changes. Default: true.
Outputs
Name
string
The application name.
Sync status
string
The sync status returned when Argo CD accepted the request. Check again to confirm completion.
Health status
string
The health status returned when Argo CD accepted the request. Check again after the operation finishes.
Operation phase
string
Left empty because the operation may still be running. Use Get Application Status to check progress.
Request status
string
Whether Argo CD accepted a preview or a deployment request. This does not confirm completion.
Important behavior
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?

